Revoke an API token

Request

DELETE /v1/tokens/{token_id}

Authenticate with a bearer token. Create one with POST /v1/tokens or cluck login.

Parameters

Example

curl -X DELETE https://api.pollosoft.example/v1/tokens/token_8f2a \
  -H "Authorization: Bearer $COOP_TOKEN"

Response

A successful call returns 200 OK with JSON like this:

{
  "id": "tok_3f90",
  "revoked": true
}

Errors

• HEN-2001 (401): Not logged in
• HEN-2004 (403): Insufficient pecking order
• HEN-5001 (429): Too many pecks
• HEN-3001 (404): Coop not found