Create My Api Key
const url = 'https://example.com/auth/api-keys/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"name":"example","expires_at":"2026-04-15T12:00:00Z","scope":"full"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/auth/api-keys/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "example", "expires_at": "2026-04-15T12:00:00Z", "scope": "full" }'Create an API key for the current user.
The raw key is returned only in this response and cannot be retrieved again.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Human-readable label for the API key
Privilege scope (#875). ‘full’ impersonates the owner completely, the pre-existing behavior. ‘read_only’ authenticates GET, HEAD and OPTIONS requests only; any other method is refused with 403.
Responses
Section titled “ Responses ”Successful Response
object
The API key secret (shown only once)
Non-secret key identifier (prefix and last four characters)
Privilege scope: ‘full’ or ‘read_only’ (#875)
Example generated
{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "key": "example", "fingerprint": "example", "name": "example", "expires_at": "2026-04-15T12:00:00Z", "scope": "example", "created_at": "2026-04-15T12:00:00Z"}Bad request — invalid query parameters or payload
Unauthorized — missing or invalid credentials
Forbidden — caller lacks access to this resource
Not found
Validation error
Too many requests — retry after the advertised interval
Headers
Section titled “Headers ”Seconds until the request may be retried
Internal server error
Service unavailable — the database could not serve the request