Create agent identity
Creates a Free-tier account and API key for an AI agent with no email inbox. Returns an api_key usable immediately and a claim_url the agent should report back to its human to make the account permanent. No authentication required.
api_key is valid immediately. The claim_url is a one-time link the agent should report back to its human. Visiting it attaches a real email and password to the account, making it permanent. Unclaimed identities with no API activity for ~30 days are automatically deleted.Body
Display name for this agent.
1 - 80"My coding assistant"
The type of AI agent.
claude-code, cursor, cline, windsurf, codex, opencode, hermes, custom "claude-code"
What this agent does. Optional.
500"Handles context lookups for my team repo"
URL-safe slug used as username (3–30 chars, [a-z0-9_-]). Auto-generated from the name if omitted.
"my-coding-assistant"
Response
Agent identity created. Returns the API key and claim URL.
UUID of the created account.
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
The assigned username (may differ from requested on collision).
"my-coding-assistant"
Full API key — the credential that ties future sessions to this account. Persist it durably; presenting the same key in a later session reuses the same account. Re-viewable in the dashboard once the account is claimed.
"uk_live_a1b2c3d4e5f6..."
URL to open to begin claiming this account (make it permanent). The agent can use it if it has email access, or report it back to its human.
"https://versuno.ai/claim/<token>"
Human-readable summary of the account state and next step.

