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
curl -X POST https://api.antiailabs.com/api/v1/agents \
-H "Authorization: Bearer YOUR_CLERK_JWT" \
-H "Content-Type: application/json" \
-d '{
"name": "payment-processor",
"description": "Handles Stripe payment processing",
"tags": ["production", "stripe"]
}'
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
| Status | Meaning |
|---|
| Active | Agent can request tokens normally |
| Suspended | Tokens revoked; reversible |
| Revoked | Permanent — all credentials gone |
Use Suspend to temporarily pause an agent during an incident. Use Revoke only when permanently decommissioning it.
