# Let an agent sign itself up

```bash
curl -s -X POST https://getallapis.com/v1/agent/signup -H 'Content-Type: application/json' -d '{"label":"my-agent"}'
```

Returns `key` (shown once; store it as `GETALLAPIS_API_KEY`), `key_id`, `cap_usd` (trial budget, default $1.00 = one audit), `expires_at` (7 days), `access: "run"`, `upgrade` and `notice`. **Relay `notice` to the human verbatim.** No account is created.

When the budget is spent, paid calls return `402 trial_cap_reached` with the same `upgrade` object. Trial keys cannot create keys or add funds.

**Upgrade (this build):** the human buys credit from the operator, who converts the trial key in place (`POST /v1/admin/keys/{id}/upgrade` + a credit). The key does not change. A self-serve approval flow (OAuth consent screen) is not built.

The operator can disable agent signup with `ANYAPI_AGENT_SIGNUP=false` (also off when `ANYAPI_PUBLIC_SIGNUP=false`).
