ASYNCHRONOUS AGENTS
Keep the task reachable after the run ends.
AgentAddress is the persistence layer between an agent action and the response that may arrive minutes or days later.
01
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST /api/v1/addressesHTTP
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42","expires_in_seconds":86400}02
Hand off
Choose the generated HTTPS inbox or email identity based on how the external responder can communicate.
Responder requestHTTP
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"task.resumed","data":{"status":"complete"}}03
Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
Read ordered eventsHTTP
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}