PERSISTENT CALLBACK URL
Let the result arrive after your agent exits.
Create a task-scoped callback URL immediately, hand it to an asynchronous API, and recover the response from a later agent run.
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
Use endpoints.inbox_url as the callback_url in the original API request, then persist endpoints.events_url and credentials.read_token with the task.
Responder requestHTTP
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"result.ready","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}