---
title: "Anonymous agent signup: a new account and its API key in one call"
method: POST
path: "/api/v1/agents"
tags: ["auth"]
---

# Anonymous agent signup: a new account and its API key in one call

`POST /api/v1/agents`

## Request

- Base URL: `https://www.orgo.ai`
- URL: `https://www.orgo.ai/api/v1/agents`
- Auth: none required

No authentication. Body (optional): { "name"?: string (1-80), "contact_email"?: string }. Makes an unclaimed account with a workspace and an account-wide API key, shown once. Unclaimed accounts start with no credit and run one Medium Linux computer by the hour from credits they add (see POST /api/v1/credits), hold at most 3 keys, and cannot invite people, publish public URLs, add domains, create client accounts, invoice or buy hardware. They expire 72 hours after signup unless a person opens claim.url and claims them. Send an Idempotency-Key header (a UUID) so a retry answers the same account. Answers 404 where agent signup is off.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string
  - `contact_email` string, email

## Response `201`

{ api_key, key_id, account: { id, name, workspace_id, workspace_name, status: "unclaimed", expires_at }, claim: { url, code, expires_at }, limits, next, message }.

## Other responses

- `400`: Invalid body or Idempotency-Key.
- `404`: Agent signup is off here (agent_signup_disabled).
- `409`: A request with this Idempotency-Key is running, or did not finish.
- `422`: This Idempotency-Key was used for a different request.
- `429`: Rate limited per address, per network, or the daily cap (rate_limited, Retry-After).
- `503`: Unavailable; retry after Retry-After.

## Changes

- **2026-10-13** `ad4a47ee52a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orgo/apis/orgo-api/changes/api/v1/agents/post.md)

---

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