Make a 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?