Update version to 3.5.8 and add support for optional org_identifier and project_identifier in Harness microclients. Modify API request URLs to conditionally include these parameters,

Author: kleinjoshuaa

CHANGES.txt

@@ -3,6 +3,16 @@ CHANGELOG
 
 This file tracks the version history and changes made to the Split/Harness FME Python API Client library.
 
+3.5.8 (December 4, 2025)
+-------------------------
+Features:
+- Added optional org_identifier and project_identifier support for Harness microclients
+  - These parameters can be set at client initialization or passed to individual method calls
+  - Parameters are only included in API request URLs when they are set (not None)
+  - When not provided, they are completely omitted from URLs rather than being passed as empty strings
+  - Applies to all Harness microclients: harness_project, harness_user, harness_group, 
+    harness_apikey, service_account, token, role, resource_group, and role_assignment
+
 3.5.7 (November 26, 2025)
 -------------------------
 Bug Fixes:

README.md

@@ -58,6 +58,15 @@ client = get_client({
     'harness_token': 'YOUR_HARNESS_TOKEN',  # Used for both Harness and Split endpoints
     'account_identifier': 'YOUR_HARNESS_ACCOUNT_ID'
 })
+
+# Option 3: Include optional org_identifier and project_identifier
+client = get_client({
+    'harness_mode': True,
+    'harness_token': 'YOUR_HARNESS_TOKEN',
+    'account_identifier': 'YOUR_HARNESS_ACCOUNT_ID',
+    'org_identifier': 'YOUR_ORG_ID',        # Optional: organization identifier
+    'project_identifier': 'YOUR_PROJECT_ID' # Optional: project identifier
+})
 ```
 
 ### Working with Split Resources in Harness Mode
@@ -97,15 +106,30 @@ Basic example:
 # Account identifier is required for all Harness operations
 account_id = 'YOUR_ACCOUNT_IDENTIFIER'
 
-# List all tokens
+# List all tokens (org_identifier and project_identifier are optional)
 tokens = client.token.list(account_id)
 for token in tokens:
     print(f"Token: {token.name}, ID: {token.id}")
 
-# List service accounts
-service_accounts = client.service_account.list(account_id)
+# List service accounts with org and project identifiers
+org_id = 'YOUR_ORG_IDENTIFIER'
+project_id = 'YOUR_PROJECT_IDENTIFIER'
+service_accounts = client.service_account.list(account_id, org_identifier=org_id, project_identifier=project_id)
 for sa in service_accounts:
     print(f"Service Account: {sa.name}, ID: {sa.id}")
+
+# If org_identifier and project_identifier are set at client initialization, you can omit them
+client = get_client({
+    'harness_mode': True,
+    'harness_token': 'YOUR_HARNESS_TOKEN',
+    'account_identifier': account_id,
+    'org_identifier': org_id,
+    'project_identifier': project_id
+})
+
+# Now you can call methods without specifying identifiers
+service_accounts = client.service_account.list()  # Uses default identifiers
+projects = client.harness_project.list()  # Uses default identifiers
 ```
 
 For most creation, update, and delete endpoints for harness specific resources, you will need to pass through the JSON body directly. 
@@ -133,21 +157,43 @@ client.harness_user.add_user_to_groups(user.id, [group.id], account_id)
 
 For detailed examples and API specifications for each resource, please refer to the [Harness API documentation](https://apidocs.harness.io/).
 
-### Setting Default Account Identifier
+### Setting Default Identifiers
 
-To avoid specifying the account identifier with every request:
+To avoid specifying identifiers with every request, you can set default values when creating the client:
 
 ```python
-# Set default account identifier when creating the client
+# Set default identifiers when creating the client
 client = get_client({
     'harness_mode': True,
     'harness_token': 'YOUR_HARNESS_TOKEN',
-    'account_identifier': 'YOUR_ACCOUNT_IDENTIFIER'
+    'account_identifier': 'YOUR_ACCOUNT_IDENTIFIER',  # Required
+    'org_identifier': 'YOUR_ORG_IDENTIFIER',          # Optional
+    'project_identifier': 'YOUR_PROJECT_IDENTIFIER'   # Optional
 })
 
-# Now you can make calls without specifying account_identifier in each request
+# Now you can make calls without specifying identifiers in each request
 tokens = client.token.list()  # account_identifier is automatically included
-projects = client.harness_project.list()  # account_identifier is automatically included
+projects = client.harness_project.list()  # account_identifier and org_identifier are automatically included (project_identifier is not used for projects endpoint)
+```
+
+**Note on Optional Identifiers:**
+- `account_identifier` is **required** for all Harness operations
+- `org_identifier` and `project_identifier` are **optional** and will be omitted from API requests if not provided
+- If `org_identifier` or `project_identifier` are not set, they will not appear in the URL at all (not even as empty parameters)
+- **Important:** The `harness_project` microclient does **not** support `project_identifier` as a query parameter. The projects endpoint only uses `org_identifier` (and `account_identifier`). Other microclients (service_account, token, role, etc.) do support `project_identifier`.
+- You can override default identifiers by passing them as parameters to individual method calls:
+
+```python
+# Override default identifiers for a specific request
+# Note: project_identifier is not used for harness_project endpoints
+projects = client.harness_project.list(
+    account_identifier='DIFFERENT_ACCOUNT_ID',
+    org_identifier='DIFFERENT_ORG_ID'
+)
+
+# Use default identifiers but override only org_identifier
+# Note: project_identifier is not used for harness_project endpoints
+projects = client.harness_project.list(org_identifier='DIFFERENT_ORG_ID')
 ```
 
 ## Quick Setup

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "splitapiclient"
-version = "3.5.7"
+version = "3.5.8"
 license = "Apache-2.0"
 description = "This Python Library provides full support for Split REST Admin API, allow creating, deleting and editing Environments, Splits, Split Definitions, Segments, Segment Keys, Users, Groups, API Keys, Change Requests, Attributes and Identities"
 classifiers = [

splitapiclient/main/harness_apiclient.py

@@ -53,6 +53,8 @@ def __init__(self, config):
                 - 'base_url_v3': Base url where the Split API v3 is hosted (optional, defaults to Split URL)
                 - 'harness_base_url': Base url where the Harness API is hosted (optional, defaults to Harness URL)
                 - 'account_identifier': Harness account identifier to use for all Harness operations (optional)
+                - 'org_identifier': Harness organization identifier to use for all Harness operations (optional)
+                - 'project_identifier': Harness project identifier to use for all Harness operations (optional)
         '''
         # Set up Split API base URLs for existing endpoints
         if 'base_url' in config:
@@ -87,8 +89,10 @@ def __init__(self, config):
         split_auth_token = self._apikey if self._apikey else self._harness_token
         harness_auth_token = self._harness_token if self._harness_token else self._apikey
 
-        # Store the account identifier
+        # Store the account identifier, org identifier, and project identifier
         self._account_identifier = config.get('account_identifier')
+        self._org_identifier = config.get('org_identifier')
+        self._project_identifier = config.get('project_identifier')
 
         # Create HTTP clients for Split endpoints
         split_http_client = HarnessHttpClient(self._base_url, split_auth_token)
@@ -114,15 +118,15 @@ def __init__(self, config):
         self._flag_set_client = FlagSetMicroClient(split_http_clientv3)
 
         # Harness-specific microclients using Harness endpoints
-        self._token_client = TokenMicroClient(harness_http_client, self._account_identifier)
-        self._harness_apikey_client = HarnessApiKeyMicroClient(harness_http_client, self._account_identifier)
-        self._service_account_client = ServiceAccountMicroClient(harness_http_client, self._account_identifier)
-        self._harness_user_client = HarnessUserMicroClient(harness_http_client, self._account_identifier)
-        self._harness_group_client = HarnessGroupMicroClient(harness_http_client, self._account_identifier)
-        self._role_client = RoleMicroClient(harness_http_client, self._account_identifier)
-        self._resource_group_client = ResourceGroupMicroClient(harness_http_client, self._account_identifier)
-        self._role_assignment_client = RoleAssignmentMicroClient(harness_http_client, self._account_identifier)
-        self._harness_project_client = HarnessProjectMicroClient(harness_http_client, self._account_identifier)
+        self._token_client = TokenMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._harness_apikey_client = HarnessApiKeyMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._service_account_client = ServiceAccountMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._harness_user_client = HarnessUserMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._harness_group_client = HarnessGroupMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._role_client = RoleMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._resource_group_client = ResourceGroupMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._role_assignment_client = RoleAssignmentMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
+        self._harness_project_client = HarnessProjectMicroClient(harness_http_client, self._account_identifier, self._org_identifier, self._project_identifier)
 
     @property
     def traffic_types(self):