v1

latestOpenAPI 3.0.32026-07-24106305257.4 KB
Client Keys

Create Agent Client Key

Create a client key scoped to a specific agent. Multiple keys per agent are allowed with different domain sets.

post/agents/{agentId}/client-keys

Path parameters

agentIdstring required

Agent Id

Request body

allowed_domainsstring[] required
namestring
ttl_secondsinteger

Optional lifetime for a short-lived key, in seconds. Omit for a permanent key. When set and allowed_domains is empty, the key is created with a wildcard (*) allowed domain.

Response

Created

client_keystring required
allowed_domainsstring[] required
namestring
resource_idstring
created_atstring
expires_atstring

ISO-8601 expiry for short-lived keys; absent for permanent keys.