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

SCIM tokens

If your organization pushes user and group information to Informatica Intelligent Cloud Services using SCIM 2.0, you can manage the SCIM tokens using the scimTokens resource. Use the scimTokens resource to list, create, and delete SCIM tokens.
You can use the following request methods:
Before you can modify SCIM tokens, ensure that the Map SAML Groups and Roles and Enable IdP to push users/groups using SCIM 2.0 options are enabled in Administrator. Your user role must also have privileges to read and update organizations.
For more information about using SCIM 2.0 and about Administrator asset privileges, see User Administration in the Administrator help.

Listing SCIM tokens

Use the scimTokens resource to request details about the SCIM tokens used by the organization.

GET request

To get a list of all SCIM tokens used by the organization, use the following URI:
/public/core/v3/scimTokens

GET response

If successful, returns each SCIM token used by the organization and its expiration date.
Returns the error object if errors occur.

GET example

To list the SCIM tokens used by your organization, you might use the following request:
GET <baseApiUrl>/public/core/v3/scimTokens
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 the organization already uses two tokens, you'll need to delete one before you can create a new token.

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

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.