Smart Agent Teams
EndpointsAPI keys

Create My Api Key

Create a personal API key and return the secret once, in `key`. Use it as `Authorization: Bearer sat_live_...`. It never expires unless `expires_in_days` (1-3650) is set. Requires a signed-in session token, not an API key (403 `SESSION_REQUIRED`). Names must be unique among active keys (409 `API_KEY_EXISTS`), and a user may hold at most 20 active keys (400 `API_KEY_LIMIT`).

POST
/api/me/api-keys

Create a personal API key and return the secret once, in key.

Use it as Authorization: Bearer sat_live_.... It never expires unless expires_in_days (1-3650) is set. Requires a signed-in session token, not an API key (403 SESSION_REQUIRED). Names must be unique among active keys (409 API_KEY_EXISTS), and a user may hold at most 20 active keys (400 API_KEY_LIMIT).

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Request Body

application/json
  1. body
expires_in_days?|null
name*Name
Length1 <= length <= 100

Response Body

Successful Response

application/json
  1. response
created_at*|null
expires_at*|null
id*Id
Formatuuid
key*Key
last_used*|null
name*Name
prefix*Prefix
curl -X POST "https://example.com/api/me/api-keys" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "created_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "key": "string",  "last_used": "2019-08-24T14:15:22Z",  "name": "string",  "prefix": "string"}

List My Api Keys GET

List the caller's active (not revoked) API keys, newest first. Only metadata is returned: name, `prefix` (the first 13 characters of the key), created, last used and expiry. The secret itself is never shown again. Works with a session token or an API key.

Revoke My Api Key DELETE

Revoke one of the caller's API keys; it stops authenticating immediately. Requires a signed-in session token, not an API key (403 `SESSION_REQUIRED`). Answers 404 `NOT_FOUND` if the key does not exist, is already revoked or belongs to another user.