agents

Self-register a zero-signup agent API key

UNauthenticated on purpose. An agent (or a dev) posts an optional name and gets back a working API key plus a ready-to-use inbox in one call; no email, no human confirmation. The plaintext key is returned ONCE and never retrievable again. IP-rate-limited AND globally rate-limited (a fixed hourly cap across all sources), and the resulting account is Free-plan, subject to a shared reduced wait-capacity pool and idle-account garbage collection. Idempotency-Key is not supported here: there is no account to scope the key to, so the header is ignored and every call mints a new key.

post/agents/register

Request

  • Base URL: https://dash.mailsocket.app/api/v1
  • URL: https://dash.mailsocket.app/api/v1/agents/register
  • Auth: none required

Request body

namestring

Optional label for the minted key. A string longer than 60 characters is 422 validation_error with fields.name (nothing is minted); a non-string value is ignored.

Response

Agent account, API key, and first inbox created.

Changes

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