Skip to main content
POST
Whether this credential is accepted

Authorizations

Authorization
string
header
required

Bearer credential for one agent: an API key or an access token (a JWT). Pass as Authorization: Bearer <credential>.

A key is shown once when it is issued and is not recoverable afterwards; an access token lives five minutes and is fetched with the agent's own client key from the access service. Treat both as secrets: they reach one agent's mail, and anything a delegation has extended to it. An access token's scope is a ceiling on what the agent may do with it.

Body

application/json

The body is of type object.

Response

The credential is accepted.

contract
string
required

The version of this API the deployment speaks.

agent
string
required

The agent this credential is.

Example:

"ag_01j9x2v8k3e0080000000000"

workspace
string
required

The account the agent belongs to.