You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/feature-management-experimentation/split-to-harness/api-for-split-admins.md
+21-3Lines changed: 21 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ Each folder includes an overview section with detailed guidance tailored for bot
13
13
14
14
## Authorization moves from Bearer Token to `x-api-key`
15
15
16
-
Historically, you have presented the API token as a bearer token with Split. With the Harness platform, API tokens must be in an x-api-key header instead. The Postman collection below was updated to reflect that on April 18th, 2025.
16
+
Historically, you have presented the API token as a bearer token with Split. With the Harness platform, API tokens must be in an `x-api-key` header instead. The Postman collection below was updated to reflect that on April 18th, 2025.
17
17
18
18
If you downloaded the Postman collection before April 18th, download an updated copy.
19
19
@@ -33,9 +33,27 @@ You can view the interactive collection experience [Before and After: APIs for S
33
33
34
34
### Are the Harness Project identifier and Split Project Id (wsId) equivalent? Can I use either in the Split Admin API endpoints after migration?
35
35
36
-
No. Once you know the Harness Project `identifier`, you must obtain the Harness Project `name`and use that to look up the Split Project ID (`wsId`) by calling the `GET /workspaces` with the **filter (by name)** option to obtain the `wsId`. Once you have the `wsId`, you proceed as usual with the Split Admin API endpoints.
36
+
No. The Harness Project `identifier`and the Split Project ID (`wsId`) are not equivalent and cannot be used interchangeably in Split Admin API endpoints.
37
37
38
-
See the discussion of **Retrieving wsId Using the Harness Project Name** in the [Projects > Harness (AFTER)](https://www.postman.com/harness-fme-enablement/harness-fme/documentation/hyphfpd/before-and-after-apis-for-split-admins?entity=folder-39aa2120-1aa4-4c0d-afc6-8679da5dd010) section of the Postman collection for more details.
38
+
After migration, you need the Split project ID (`wsId`) to call Split Admin API endpoints that require a project (workspace) identifier. However, you no longer need to rely on the Harness project name to retrieve the `wsId`.
39
+
40
+
To retrieve the `wsId` for a Harness project:
41
+
42
+
1. Call the [Get Projects (Workspaces) endpoint](https://docs.split.io/reference/get-workspaces).
43
+
1. Filter the results using one of the following options:
44
+
45
+
* Recommended: Use the `organizationIdentifier` and `projectIdentifier` query parameters.
46
+
* Alternatively, use the `name` query parameter with the Harness project name (not the Harness project ID).
47
+
48
+
1. Extract the `id` field from the response and use it as the `wsId` in subsequent Split Admin API calls.
49
+
50
+
:::tip Notes
51
+
- Harness project names are not read-only and can be changed.
52
+
- Filtering by `organizationIdentifier` and `projectIdentifier` provides a more stable way to retrieve the correct `wsId`.
53
+
- The Harness platform project ID cannot be used directly in Split Admin API endpoints.
54
+
:::
55
+
56
+
For more information, see the **Retrieving a Project (Workspace) ID Using Harness Identifiers** section of the [Postman collection](https://www.postman.com/harness-fme-enablement/harness-fme/folder/qqutu4c/harness-after).
39
57
40
58
### Will this collection be published on GitHub as well?
Copy file name to clipboardExpand all lines: release-notes/feature-management-experimentation.md
+14-2Lines changed: 14 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,20 @@ These release notes describe recent changes to Harness Feature Management & Expe
16
16
17
17
## January 2026
18
18
19
+
### [New Enhancement] Identifier-based Filtering for Harness FME Projects
20
+
----
21
+
#### 2026-01-23
22
+
23
+
The Split [Get Projects (Workspaces) Admin API](https://docs.split.io/reference/get-workspaces) now provides Harness identifiers and supports identifier-based filtering, making it easier and more reliable to retrieve project (workspace) IDs, or `wsId`, after migration to Harness.
24
+
25
+
Previously, workspace ID retrieval relied on filtering by [Harness project name](https://www.postman.com/harness-fme-enablement/harness-fme/folder/qqutu4c/harness-after). With this enhancement, you can now filter by `organizationIdentifier` and `projectIdentifier`, providing a more stable way to programmatically retrieve workspace IDs for Split Admin API calls.
-[API for Split Admins](/docs/feature-management-experimentation/split-to-harness/api-for-split-admins#are-the-harness-project-identifier-and-split-project-id-wsid-equivalent-can-i-use-either-in-the-split-admin-api-endpoints-after-migration)
0 commit comments