---
title: "POST /v1/scim-directories/{id}/rotate-bearer-token"
method: POST
path: "/v1/scim-directories/{id}/rotate-bearer-token"
tags: ["SSOReadyService"]
---

# POST /v1/scim-directories/{id}/rotate-bearer-token

`POST /v1/scim-directories/{id}/rotate-bearer-token`

## Request

- The document declares no server URL.
- Auth: none declared

Rotates a SCIM directory's bearer token.

 Every SCIM directory has a bearer token that SSOReady uses to authenticate requests sent from your customer's
 Identity Provider. These bearer tokens are assigned by SSOReady, and are secret. Newly-created SCIM directories do
 not have any bearer token at all; you must use this endpoint to get an initial value.

 Rotating a SCIM directory bearer token immediately invalidates the previous bearer token, if any. Your customer
 will need to update their SCIM configuration with the new value to make SCIM syncing work again.

 SSOReady only stores the hash of these bearer tokens. If your customer has lost their copy, you must use this
 endpoint to generate a new one.

## Path parameters

- `id` string, required

## Response `200`

OK

- RotateSCIMDirectoryBearerTokenResponse
  - `bearerToken` string: The new, updated bearer token. Do not log or store this bearer token. It is an authentication token that your customer should securely input into their Identity Provider.

## Other responses

- `default`: Default error response

## Changes

- **2024-08-16** `132245ed6de0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/changes/v1/scim-directories/:id/rotate-bearer-token/post.md)

---

[API](https://skmtc.dev/ssoready/apis/ssoreadyservice-api.md) - [All operations](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/revisions/0827d713f08e?raw)
