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
organizationIdstringRequired

A unique entity identifier

Pattern: ^[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.

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?

Powered by GitBook