> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goantiai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Register an Agent

> Create an agent identity in Anti AI.

An **agent** is a registered identity for your AI workload — like a user account, but for a machine.

## From the dashboard

1. Go to **Agents → New Agent**
2. Enter a name (e.g. `payment-processor`), description, and tags
3. Click **Create Agent**
4. Copy the **Client Secret** — shown once only

<Warning>
  Store the Client Secret in your secrets manager or `.env` immediately. If you lose it, rotate credentials from the agent's Settings tab.
</Warning>

## From the API

```bash theme={null}
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  |

<Tip>
  Use **Suspend** to temporarily pause an agent during an incident. Use **Revoke** only when permanently decommissioning it.
</Tip>