Agent signup

Request an API key for a person, by email

No apiKey needed. Emails the person a confirmation link (valid 30 minutes). A new account says what they do (role), picks a language and chooses a password there and clicks "Create account and allow"; an existing account clicks "Allow"; they can also decline. Nothing is created until they click. Then poll /api/agent_signup_status every pollAfterSeconds (5 s) for up to ~30 minutes. The response is the same whether or not the email already has an account. Abuse protections: inbox confirmation required, disposable email domains refused, rate limits (3/hour per email, 10/day per IP, plus a global daily cap). For agents with no browser in the loop (Claude Code, scripts, the local MCP server); ChatGPT and Claude connectors use OAuth instead.

post/api/agent_signup

Request

  • Base URL: https://app.pedra.ai
  • URL: https://app.pedra.ai/api/agent_signup
  • Auth: none required

Request body

emailstring email required

The email of the person the agent works for.

agentNamestring

Shown in the email and on the confirmation page, e.g. "Claude Code".

Response

Confirmation email sent.

requestIdstring
status'pending'
expiresAtstring date-time
pollAfterSecondsinteger
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.