Skip to content
Plune Plune Plune Docs

Revoke every API token of the verified domains

DELETE
/v1/companies/{id}/sso/tokens
 
curl --request DELETE \
  --url https://beta-api.plune.ai/v1/companies/example/sso/tokens \
  --header 'Content-Type: application/json' \
  --cookie plune_session=<plune_session> \
  --data '{ "confirm": 0 }'

Owner and managers (#1610). confirm must equal the number of tokens that would be revoked; when the list changed since it was read the answer is 409 sso_confirm_mismatch with the fresh count, and nothing is revoked. A revoked token answers 401 on its next request. One row of the company’s log (counts only). CI pipelines that use these tokens will fail: see affectedProjects. 20 a minute a person.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Request Body required

Section titled “Request Body required ”
Media type application/json
object
confirm
required

The number of tokens the caller was shown (total of the list). Refused with the fresh count when it differs.

integer
Example 
{
  "confirm": 0
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

How many were 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
}

400

Section titled “400 ”

confirm is missing or not a whole number

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

401

Section titled “401 ”

No / invalid session

404

Section titled “404 ”

No such company, or the caller is not its owner or a manager

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

409

Section titled “409 ”

sso_confirm_mismatch: the body has the fresh count and the impact

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

429

Section titled “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

Section titled “Headers ”
Retry-After
integer

Seconds until the window rolls over