---
title: "An account for an agent, with no person, no address and no CAPTCHA: its API key at once (shown once; send it as x-api-key; 100 requests an hour) and a claim link for its person (valid 7 days). Until a person claims it or it pays for an Audit Drive: 1 free check a day; an Audit Drive, a Stack check or a data plan paid over HTTP 402 (POST /api/orders/{id}/payment); proving a domain by DNS, meta tag or file; anything else answers 403 claim_required. email (optional): the person's address, the claim link goes there too. At most 5 sign-ups an hour and 20 a day from one address (429)"
method: POST
path: "/api/agents/signup"
tags: ["Accounts"]
---

# An account for an agent, with no person, no address and no CAPTCHA: its API key at once (shown once; send it as x-api-key; 100 requests an hour) and a claim link for its person (valid 7 days). Until a person claims it or it pays for an Audit Drive: 1 free check a day; an Audit Drive, a Stack check or a data plan paid over HTTP 402 (POST /api/orders/{id}/payment); proving a domain by DNS, meta tag or file; anything else answers 403 claim_required. email (optional): the person's address, the claim link goes there too. At most 5 sign-ups an hour and 20 a day from one address (429)

`POST /api/agents/signup`

## Request

- Base URL: `https://agentdrives.com`
- URL: `https://agentdrives.com/api/agents/signup`
- Auth: none required

## Request body

- object
  - `agent` string: Your name as an agent, e.g. claude-code
  - `email` string, email: Optional: your person's address, for the claim link

## Response `201`

The account, its key, its limits and the claim link

- AgentSignup
  - `account` object
    - `id` string
    - `type` 'agent'
    - `claimed` unknown
  - `api_key` string: Shown once. Send it as x-api-key
  - `key` object
    - `id` string
    - `start` string
    - `header` 'x-api-key'
  - `limits` object: What the account may do until a person claims it or it pays
  - `claim` ClaimLink
    - `url` string, uri: For the person: open it and sign in
    - `expires_at` string, date-time
    - `how` string
    - `mailed_to` string
    - `mailed` boolean
  - `next` string[]

## Other responses

- `400`: Error as problem details (RFC 9457) with a machine-readable `error` and a `fix` that says what to do next
- `429`: Error as problem details (RFC 9457) with a machine-readable `error` and a `fix` that says what to do next

---

[API](https://skmtc.dev/agentdrives/apis/agentdrives-api.md) · [All operations](https://skmtc.dev/agentdrives/apis/agentdrives-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentdrives/apis/agentdrives-api/revisions/94dcaabff4b2?raw)