Skip to content

Commit 3b2ca96

Browse files
alai97Harness
authored andcommitted
FMEPRD-400 Update API for Split Admins Documentation (#100910)
* 144ac2 Merge branch 'main' into update-api-for-split-admins * 23fd82 FMEPRD-400
1 parent 1c88eab commit 3b2ca96

File tree

2 files changed

+35
-5
lines changed

2 files changed

+35
-5
lines changed

docs/feature-management-experimentation/split-to-harness/api-for-split-admins.md

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Each folder includes an overview section with detailed guidance tailored for bot
1313

1414
## Authorization moves from Bearer Token to `x-api-key`
1515

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.
1717

1818
If you downloaded the Postman collection before April 18th, download an updated copy.
1919

@@ -33,9 +33,27 @@ You can view the interactive collection experience [Before and After: APIs for S
3333

3434
### Are the Harness Project identifier and Split Project Id (wsId) equivalent? Can I use either in the Split Admin API endpoints after migration?
3535

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.
3737

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).
3957

4058
### Will this collection be published on GitHub as well?
4159

release-notes/feature-management-experimentation.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,20 @@ These release notes describe recent changes to Harness Feature Management & Expe
1616

1717
## January 2026
1818

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.
26+
27+
#### Related documentation
28+
29+
- [Get Projects (Workspaces) API](https://docs.split.io/reference/get-workspaces)
30+
- [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)
31+
- [Postman Collection](https://www.postman.com/harness-fme-enablement/harness-fme/folder/qqutu4c/harness-after)
32+
1933
### [New Feature] FME Steps in Harness Pipelines is in Beta
2034
----
2135
#### 2026-01-23
@@ -56,8 +70,6 @@ This feature enables you to integrate the plugin into multi-platform Flutter app
5670

5771
- [Flutter Plugin](/docs/feature-management-experimentation/sdks-and-infrastructure/client-side-sdks/flutter-plugin)
5872

59-
## January 2026
60-
6173
### [New Enhancement] Certificate pinning status handler for iOS SDK and iOS Suite
6274
---
6375
#### 2026-01-15

0 commit comments

Comments
 (0)