Hoppa till innehållet

Menu

Keys

More ways to use this page

Revoke a key

DELETE/v1/tokens/{id}

TypeScript sendora.tokens.revoke(tokenId)

Python sendora.tokens.revoke(token_id)

Key sk_… a server key

The key stops working at once. The last live key of a server cannot be revoked, so a server is never locked out; revoking a key that is already revoked is fine.

Parameters

  • idin pathstring (uuid)required

    The key id.

Responses

204Removed. The body is empty.

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes.
not_found404No such key of this server.
last_token409This is the only live key of the server; create another before revoking it.