Hoppa till innehållet

Menu

Servers

More ways to use this page

Revoke a key of a server

DELETE/v1/servers/{id}/tokens/{tokenId}

TypeScript account.servers.tokens.revoke(serverId, tokenId)

Python account.servers.tokens.revoke(server_id, token_id)

Key ak_… an account 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 server id.

  • tokenIdin 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 server of this account, or no such key of the server.
last_token409This is the only live key of the server; create another before revoking it.