Skip to content

Revoke a SCIM token

DELETE
/v1/companies/{id}/scim/tokens/{tokenId}
curl --request DELETE \
--url https://beta-api.plune.ai/v1/companies/example/scim/tokens/example \
--cookie plune_session=<plune_session>

The next request with it is 401. A company log entry scim.token_revoked. The owner only, with the session; 20 a minute. A company without Enterprise in active or grace is refused 403 enterprise_required; it loses nothing and nobody is switched off.

id
required
string
tokenId
required
string

Revoked

No session

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Not the owner, or no Enterprise

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No such live token of the company, or a company the caller is not in

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over