Servers
More ways to use this page
Read a key of a server
GET/v1/
TypeScript account
Python account
Key ak_… an account key
Parameters
idin pathstring (uuid)requiredThe server id.
tokenIdin pathstring (uuid)requiredThe key id.
Responses
200A key of this server; the value itself is shown only when it is created.
tokenIdstring (uuid)requirednamestringrequiredThe name given at creation, for people to tell keys apart.
prefixstringrequiredThe first characters of the key, to match it with a value in hand.
createdAtstring (date-time)requiredrevokedAtstring (date-time) or nullrequired
Example
{
"tokenId": "3b0c9e2f-6d4a-4e8b-8a1c-9f2d7e6c5b40",
"name": "default",
"prefix": "sk_a1b2c3d4e5",
"createdAt": "2026-09-20T12:00:00.000Z",
"revokedAt": null
}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.
| Code | Status | Meaning |
|---|---|---|
unauthorized | 401 | The key is missing, malformed or revoked. |
wrong_ | 403 | The 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_ | 404 | No such server of this account, or no such key of the server. |