Rotate the token of a SCIM connection
Replaces the token of a SCIM connection. The previous token stops working immediately, and the new token is only returned in this response.
post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequiredPattern:
A unique entity identifier
^[a-zA-Z0-9_-]+$scimConnectionIdstringRequired
The unique id of the SCIM connection
Responses
200
Token rotated
application/json
A SCIM connection with its token, returned only when the token is created.
tokenstringRequired
Bearer token to configure in the identity provider. It can't be retrieved again.
404
Not Found
application/json
post/orgs/{organizationId}/scim/connections/{scimConnectionId}/token
POST /v1/orgs/{organizationId}/scim/connections/{scimConnectionId}/token HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"connection": {
"object": "scim-connection",
"id": "text",
"label": "text",
"provider": "okta",
"baseURL": "https://example.com",
"tokenHint": "text",
"tokenCreatedAt": "2026-01-01T00:00:00.000Z",
"lastUsedAt": "2026-01-01T00:00:00.000Z",
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z",
"urls": {
"location": "https://example.com"
}
},
"token": "text"
}Last updated
Was this helpful?