Revoke an API key

Revoke one key of the authenticated account. Revoking a key that is already revoked returns the same answer again rather than an error, so a retried request is never rejected.

delete/v1/keys/{key_id}

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/keys/{key_id}
  • Auth: HTTP bearer

Path parameters

key_idstring required

The key's public identifier, such as "key_1f8b3c7d5e2a49061f8b3c7d5e2a4906".

Response

The key, now revoked.

idstring required

The key's public identifier: "key_" followed by 32 lowercase hexadecimal characters.

namestring required
display_prefixstring required

The first characters of the secret, enough to tell keys apart in a list.

status'active' | 'revoked' required
created_atstring date-time required
revoked_atstring date-time nullable required
last_used_atstring date-time nullable required
monthly_overage_capinteger nullable required

The most overage credits this key may take on per calendar month (UTC). Null means the key sets no cap of its own.

Changes

No recorded changes to this operation across all 1 revision of this API.