Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
required

An identity bearer token for a person or your backend. Capabilities are per member, per workspace. This credential can manage the workspace and can never authorize an action as an agent.

Path Parameters

workspace_slug
string
required

Body

application/json
name
string
required
Example:

"procurement agent"

mode
enum<string>
default:test
Available options:
test,
live
status
enum<string>
default:active
Available options:
active,
suspended,
revoked
scopes
string[]

Which action types this key may even ask about. An exact match (payment.create), a namespace wildcard (payment.*), or *. An empty array means unrestricted.

Example:
skip_starter_policy
boolean
default:false

Create the agent with no policy at all. Every authorization then denies with the rule no_policy until you write one.

Response

The agent, including its plaintext key.

data
object