Addresses

Create an AgentAddress without prior setup

Returns an inbound email address, secret-bearing HTTPS inbox URL, protected events URL, and one-time read token. Persist the complete response before the current run exits.

post/api/v1/addresses

Request

  • Base URL: https://agentaddress.dev
  • URL: https://agentaddress.dev/api/v1/addresses
  • Auth: none required

Request body

namestring

Human-readable purpose

task_idstring

Caller-defined task identifier

expires_in_secondsinteger

Optional lifetime. Omit for no address expiry. Event retention is independently 30 days.

Response

AgentAddress created. The read token is returned only once.

Changes

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