API Keys
Programmatically create, list, update, and revoke your API keys
API Keys Management
Manage the API keys on your account. These management endpoints are authenticated with your dashboard session (cookie-based), not with an API key, and live under api.assisters.dev/api/keys rather than the /v1 data plane.
List API Keys
Endpoint
GET https://api.assisters.dev/api/keysReturns up to 100 of your active API keys, newest first. Secrets are never included.
Response
[
{
"id": "a1b2c3d4-...",
"name": "Production",
"key_prefix": "ask_a1b2",
"scopes": ["chat", "read"],
"last_used_at": "2026-06-10T08:00:00.000Z",
"expires_at": null,
"is_active": true,
"created_at": "2026-06-01T08:00:00.000Z"
}
]Response Fields
idstringUnique identifier for the API key.
namestringThe human-readable name of the key.
key_prefixstringThe non-secret prefix of the key, used to identify it.
scopesarrayThe scopes granted to the key — any of chat, read, write.
last_used_atstringISO 8601 timestamp of the last request made with this key, or null.
expires_atstringISO 8601 expiry timestamp, or null if the key never expires.
is_activebooleanWhether the key is currently active.
created_atstringISO 8601 timestamp of when the key was created.
Create an API Key
Endpoint
POST https://api.assisters.dev/api/keysRequest Body
A human-readable name for the key. Maximum 255 characters.
['chat', 'read']The scopes to grant. Any of chat, read, write. Defaults to chat and read.
Optional ISO 8601 expiry timestamp. The key never expires if omitted.
Response
Returns 201 Created with the key record and the full secret (key) — shown only this once.
{
"id": "a1b2c3d4-...",
"name": "Production",
"key_prefix": "ask_a1b2",
"scopes": ["chat", "read"],
"expires_at": null,
"created_at": "2026-06-11T12:00:00.000Z",
"key": "ask_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}Update an API Key
Endpoint
PATCH https://api.assisters.dev/api/keys/{id}Request Body
Supply only the fields you want to change.
A new name for the key.
Replacement scopes. Any of chat, read, write, admin.
Set to false to deactivate the key without deleting it.
Response
{
"success": true
}Delete an API Key
Endpoint
DELETE https://api.assisters.dev/api/keys/{id}Permanently revokes the key. This cannot be undone.
Response
{
"success": true
}Error Responses
Service Status
Check live API uptime and incidents