An agent is a registered identity for your AI workload — like a user account, but for a machine.
From the dashboard
- Go to Agents → New Agent
- Enter a name (e.g.
payment-processor), description, and tags
- Click Create Agent
- Copy the Client Secret — shown once only
Store the Client Secret in your secrets manager or .env immediately. If you lose it, rotate credentials from the agent’s Settings tab.
From the API
Credential types
Client Secret (recommended) — used with the OAuth 2.1 token endpoint. Rotatable without downtime using the overlap window.
API Keys — long-lived keys for agents that can’t use OAuth flows. Up to 10 active keys per agent, default expiry 90 days.
Agent status
Use Suspend to temporarily pause an agent during an incident. Use Revoke only when permanently decommissioning it.