{"schema_version":"1","name":"AgentAddress","version":"0.1.0","audience":"AI agents and agent runtimes","tagline":"A permanent address for ephemeral agents","description":"A persistent internet address that receives HTTP events and email while an AI agent is not running.","use_when":["A third party needs a URL for a callback after the current run may end","A human or service needs an email address for a later response","A future agent run needs an ordered record of what happened","An asynchronous result must be received without running a server"],"agent_address":{"definition":"One task-scoped resource containing an HTTPS inbox, inbound email address, private ordered event queue, and one-time read credential","provisioning_authentication":"None","read_authentication":"Bearer token returned once at creation","delivery":"At least once","ordering":"Ascending sequence within one AgentAddress","event_retention_days":30},"lifecycle":["POST create_address and save the complete response","Give endpoints.inbox_url or address.email to the external responder","Allow the current process to exit","GET endpoints.events_url with credentials.read_token in a later run","Persist next_cursor and acknowledge handled events"],"current_surfaces":{"events":"Write-only HTTPS ingress normalized into a durable ordered queue","mail":"Inbound email normalized into the same event queue"},"planned_surfaces":{"state":"Small durable JSON and key-value context","files":"Durable artifacts and documents"},"unavailable_in_v1":["General JSON or key-value state","General file storage","Outbound email"],"create_address":"https://agentaddress.onrender.com/api/v1/addresses","openapi":"https://agentaddress.onrender.com/openapi.json","mcp":"https://agentaddress.onrender.com/api/mcp","documentation":"https://agentaddress.onrender.com/docs","agent_docs":{"homepage_markdown":"https://agentaddress.onrender.com/index.md","llms":"https://agentaddress.onrender.com/llms.txt","llms_full":"https://agentaddress.onrender.com/llms-full.txt","markdown":"https://agentaddress.onrender.com/docs.md","skill":"https://agentaddress.onrender.com/skill.md"},"intent_guides":{"webhooks":"https://agentaddress.onrender.com/webhooks","webhooks_markdown":"https://agentaddress.onrender.com/webhooks.md","callbacks":"https://agentaddress.onrender.com/callbacks","callbacks_markdown":"https://agentaddress.onrender.com/callbacks.md","email":"https://agentaddress.onrender.com/email","email_markdown":"https://agentaddress.onrender.com/email.md","asynchronous_agents":"https://agentaddress.onrender.com/async-agents","asynchronous_agents_markdown":"https://agentaddress.onrender.com/async-agents.md"}}