sov_live_ keys that you assign to your production agents. These endpoints operate at the account level — they manage the keys themselves, not the agent data those keys protect. Because the server never stores raw key material, the full secret for any new key is returned exactly once at creation time; you are responsible for storing it securely.
POST /api-keys
Generate a newsov_live_ API key. The key is stored server-side as a SHA-256 hash only — the plaintext raw_secret is returned once and never accessible again.
A human-readable label for this key (e.g.
"my-trading-agent"). Between 1 and 128 characters. Used for identification in the dashboard and in list responses.Response — 201 Created
The full
sov_live_ key secret. This is the only time you will receive it. Store it immediately in a secret manager or environment variable.curl Example
GET /api-keys
Retrieve a list of all API keys — active and revoked — associated with the authenticated account. Keys are returned in masked form; the raw secret is never re-exposed.Response — 200 OK
Returns a JSON array of key records:curl Example
DELETE /api-keys/:id
Revoke an API key immediately. Revocation is permanent and cannot be undone. Any agent still using the key will receive401 api_key_revoked on all subsequent requests.