REST API Reference > Platform REST API version 3 resources > Managing SCIM tokens
  

Managing SCIM tokens

List, create, and delete SCIM tokens.

Listing SCIM tokens

Use the scimTokens resource to request details about the SCIM tokens that you created.

GET request

To get a list of the SCIM tokens you created, use the following URI:
/public/core/v3/scimTokens

GET response

If successful, returns each SCIM token that you created and its expiration date.
Returns the error object if errors occur.

GET example

To list the SCIM tokens you created, you might use the following request:
GET <baseApiUrl>/public/core/v3/scimTokens
Content-type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>
A successful response might look like the following example:
[
{
"id": "im2hLfwsRCvl6WG64Geqi0",
"value": "8fiXOaFR**************",
"expiry": "2025-04-28T21:05:31.000Z",
"status": "active"
}
]

Creating a SCIM token

Use the scimTokens resource to create a SCIM token. If you already have two tokens, you'll need to delete one before you can create a new token, even if one or both tokens are expired.

POST request

To create a SCIM token, use the following URI:
/public/core/v3/scimTokens

POST request example

To create a token, your request might look something like the following example:
POST <baseApiUrl>/public/core/v3/scimTokens
Content-type: application/json
Accept: application/json
INFA-SESSION-ID: <SessionId>

POST response

Returns the token response object for the token that you created.
Returns an error object if errors occur.
A successful response might look like the following example:
{
"id": "hTc5rzwEFKMh761VofJoG1",
"value": "k7UxoAAAACMAAAACAQAAAAEBAgAAAAyufel1d7nvOzJh5khiVmxxXrnYJl1iR23aBQtVPKPLTiB0qqLCp-davEg50diXElP4-Q==0s3URI0up6Ebu4sLzgtSGC",
"expiry": "2025-05-06T04:54:53.594Z",
"status": "active"
}

Deleting a SCIM token

Use the scimTokens resource to delete a SCIM token.
To delete a SCIM token, send a DELETE request using the following URI:
/public/core/v3/scimTokens/<token_id>
A successful response returns the 204 response code. If errors occur, an error object is returned.