discovery

Email a 6-digit sign-in code (step 1 of agent onboarding without a browser)

Public, unauthenticated. Sends a 6-digit code good for 10 minutes to the given address. Always 200 for a well-formed email, whether or not an account exists — this endpoint never confirms or denies an account's existence. Rate limited per email and per client IP. The human reads the code out of their inbox and gives it to the agent, which calls POST /v1/auth/verify-code next.

post/v1/auth/request-code

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/auth/request-code
  • Auth: none required

Request body

emailstring email required

Lowercased and trimmed before use. Always 200s for a well-formed address.

Response

ok

oktrue required
expires_ininteger required
nextstring required

Changes

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