Revoke one API token of a person on a verified domain

DELETE

/v1/companies/{id}/sso/tokens/{tokenId}

curl --request DELETE \
  --url https://beta-api.plune.ai/v1/companies/example/sso/tokens/example \
  --cookie plune_session=<plune_session>

• beta
• production
• local

Owner and managers (#1610). A token of anyone else, an unknown, expired or already revoked one is 404. One row of the company’s log. 20 a minute a person.

Authorizations

• cookieAuth

Parameters

Path Parameters

id

required

string

tokenId

required

string

Responses

200

Revoked

Media type application/json

object

affectedProjects

required

The distinct projects the tokens write to.

Array<object>

object

id

required

string

name

required

string

unboundTokens

required

Tokens that belong to no project of their own: they follow their owner’s default project.

integer

revoked

required

integer

Example ^generated

{
  "affectedProjects": [
    {
      "id": "example",
      "name": "example"
    }
  ],
  "unboundTokens": 1,
  "revoked": 1
}

401

No / invalid session

404

No such company, or the caller is not its owner or a manager, or no such token on the domain

Media type application/json

object

error

required

string

Example ^generated

{
  "error": "example"
}

429

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"
}

Headers

Retry-After

integer

Seconds until the window rolls over