Generate SCIM Token
Setting up SCIM provisioning for an organisation:
POST /organisations/{org_id}/scim/token(this endpoint) - mint a bearer token. The plaintext value is returned exactly once; only its hash is stored, so save it now.- Configure the identity provider (Okta, Azure AD, ...) with the returned
scim_base_urland token. PUT /organisations/{org_id}/scim/role-mappings- define which SCIM group maps to which organisation role, if group-based roles are wanted.POST /organisations/{org_id}/scim/sync- recompute existing users' roles against the mapping table; role-mapping changes are not applied retroactively without this.
Regenerating the token immediately invalidates the previous one.
Generate (or rotate) the organisation's SCIM bearer token.
Authorization: caller must be the owner.
The plaintext token is returned exactly once - only its hash is stored. Rotating invalidates any previously issued token immediately.
Authorization
OAuth2AuthorizationCodeBearer AuthorizationBearer <token>
In: header
Path Parameters
org_id*Org Id
Format
uuidQuery Parameters
verify_locally?Verify Locally
Default
trueResponse Body
application/json
application/json
curl -X POST "https://example.com/v1/organisations/497f6eca-6276-4993-bfeb-53cbbbba6f08/scim/token"{ "token": "string", "scim_base_url": "string"}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string" } ]}