Make a Token

POST /v1/endpoints/{uuid}/scim/token

Make the endpoint's SCIM token, or a new one, and turn SCIM on. The token is answered once (token): paste it, with the base_url, in your identity provider. A previous token stops at once, so your provider's calls fail until you paste the new one there.

Path parameters

uuid string (uuid) Req
The endpoint's uuid from /endpoints.

Response (201 Created)

token string
The token, scim_ and 43 characters. Your provider sends it as Authorization: Bearer scim_…. It isn't shown again.
token_hint · base_url · enabled
Its last 4 characters, the URL your provider calls, and true.

Errors

401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks endpoints:update in the active account, or your plan doesn't have SCIM ("code": "entitlement_required", "entitlement_required": "endpoint_scim").
404 Not Found
No such endpoint in your active account.
409 Conflict
The endpoint is paused over your plan's quota ("code": "quota_paused").
Request
curl -X POST "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/scim/token" \ -H "X-API-KEY: <your_api_key>"
CLI
ngris api endpoint-scim token 019bb1e4-e785-77d2-9966-c3cff31d0a0e --yes
Response — 201 Created
{ "token": "scim_8bQ3m-Zr1xYtW0pK7sV2nL5cH9dJ4fG6aE0uI3oR", "token_hint": "I3oR", "base_url": "https://api.ngris.com/scim/v2/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e", "enabled": true, "message": "Copy the token now: ngris shows it only once. Paste it, with the base URL, in your identity provider's SCIM settings." }
Was this helpful?
On this page
Make a Token
Was this helpful?