Skip to navigation
Runtype APIAgents

Create an agent client secret

Create an rt_agent_sk_ client secret for the token endpoint. It is shown once. An agent holds at most two active secrets, so you can rotate without downtime: create the new one, switch the agent, then revoke the old one.

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired
Agent ID

Request

This endpoint expects an object.
lifetimeDaysintegerOptional1-365

Days until the secret expires; defaults to 90, at most 365.

Response

The new secret
clientIdstring
clientSecretstring

The rt_agent_sk_ secret. Shown only in this response; Runtype stores only its hash.

credentialobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error