Agent signups
Sign up an agent
Get a new Orgo account and API key in one unauthenticated call, with no email or person present.
POST
Sign up an agent
Makes an unclaimed account with one workspace and an account-wide API key. No
Authorization header is needed. The account starts with $2 of credit, which runs a Medium Linux computer by the hour (not AI). Add credit to keep it running, to use AI, and to unlock more computers and workspaces. The account expires 72 hours after signup unless a person claims it with `claim.url` or it buys $5 of credit in all. The whole flow is in Let an agent sign up on its own.
Headers
A unique value per signup, such as a UUID (8 to 255 printable characters). A retry with the same key and body from the same address returns the first answer with
Idempotent-Replayed: true, and makes no second account. Keys last 24 hours. Omitted: every request makes a new account.Body
The body is optional. Send no body, or a JSON object with either field.The agent’s name, 1 to 80 characters. The workspace is named after it (
my-agent’s workspace). Omitted: the workspace is named Agent workspace.An address for the agent’s operator, up to 320 characters. Stored with the account. Nothing is sent to it.
Response
id, name, workspace_id, workspace_name, status (always unclaimed), and expires_at, when the account expires unless a person claims it or it buys $5 of credit in all.url, the link a person opens to claim the account; code, a short XXX-XXX-XXX code to show them; and expires_at, when the link stops working (7 days after it was made).What the account may do until it is claimed:
computers (1), computers_after_adding_credit (5), workspaces (1), workspaces_after_adding_credit (5), computer (os, size, cpu, ram_gb, disk_gb), billing, ai, api_keys, and not_until_claimed.The calls to make next, with your workspace id filled in:
add_credits (a Checkout link for your person, or POST /api/v1/credits over MPP where MPP payments are on), create_computer, create_computer_body, use_computer, refresh_claim_link, and docs.Example
Response
Errors
Every error body is{ "error": "…", "code": "…" }.
The rate limits are 3 signups an hour and 10 a day per address (an IPv6 address counts as its /64), 20 a day per network (an IPv4 /24 or an IPv6 /48), and 500 a day for everyone. A refused request counts against none of them, and an idempotent replay counts against none of them.
Headers
Body
application/json
Response
The account, its key (shown once), and its claim link.