SCIM
GET
/v1/orgs/{org_id}/scim/v2/GroupsList Groups
List role-backed SCIM Groups for the organization.
SCIM bearer tokenscope: scim provisioningoperation_id: scim.listGroups
Authentication
Send Authorization: Bearer <scim-token>. Mint it via POST /v1/orgs/{org_id}/scim/token (admin only) and store it with your IdP, so the integration can be revoked on its own.
SDK install
pip install znyx-sdknpm install @znyx/sdkCode samples
Request
curl -X GET "$ZNYX_API_URL/v1/orgs/00000000-0000-0000-0000-000000000000/scim/v2/Groups?startIndex=1&count=100" \ -H "Authorization: Bearer $ZNYX_TOKEN"
Response
application/json
Successful Response
null
Schema: any
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
| org_id#path | string | required | - |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| startIndex#query | integer | optional | - |
| count#query | integer | optional | - |
Header parameters
| Name | Type | Required | Description |
|---|---|---|---|
| authorization#header | string | null | optional | - |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Response schema
any
Errors & what triggers them
| Code | Trigger | Fix |
|---|---|---|
| 401 | Missing or expired Authorization header. | - |
| 403 | Token does not have org access (wrong org_id, or insufficient role). | - |
| 404 | Resource does not exist in this org. | - |