{"openapi":"3.1.0","info":{"title":"ZeroMail API","version":"0.0.0","description":"Agent-first, receive-only email."},"servers":[{"url":"https://api.withzero.com"}],"externalDocs":{"description":"ZeroMail implementation guide","url":"https://api.withzero.com/docs"},"paths":{"/v1/mailboxes":{"post":{"operationId":"provisionMailbox","x-receive-only":true,"x-zeromail-capability":{"id":"mail.mailbox.provision","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}":{"get":{"operationId":"getMailbox","x-receive-only":true},"patch":{"operationId":"updateMailbox","x-receive-only":true}},"/v1/mailboxes/{id}/handle":{"post":{"operationId":"claimHandle","x-receive-only":true,"x-zeromail-capability":{"id":"mail.handle.claim","version":1,"receive_only":true,"free":false},"x-payment-info":{"priceAtomic":"1000000","asset":"USDC","rails":["x402","mpp"],"period":"month"}}},"/v1/mailboxes/{id}/external-links":{"post":{"operationId":"linkExternal","x-receive-only":true,"x-zeromail-capability":{"id":"mail.external.link","version":1,"receive_only":true,"free":false},"x-payment-info":{"priceAtomic":"1000000","asset":"USDC","rails":["x402","mpp"],"period":"month"}},"get":{"operationId":"listExternalLinks","x-receive-only":true}},"/v1/mailboxes/{id}/external-links/{linkId}":{"delete":{"operationId":"deleteExternalLink","x-receive-only":true}},"/v1/mailboxes/{id}/addresses":{"get":{"operationId":"listAddresses","x-receive-only":true}},"/v1/mailboxes/{id}/addresses:rotate":{"post":{"operationId":"rotateAddress","x-receive-only":true}},"/v1/mailboxes/{id}/messages":{"get":{"operationId":"listMessages","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.list","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/messages/{msgId}":{"get":{"operationId":"getMessage","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.get","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/messages:batchGet":{"post":{"operationId":"batchGetMessages","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.get","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/messages/{msgId}/raw":{"get":{"operationId":"getMessageRaw","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.get","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/messages/{msgId}/attachments/{attId}":{"get":{"operationId":"getAttachment","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.get","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/messages:markRead":{"post":{"operationId":"markRead","x-receive-only":true}},"/v1/mailboxes/{id}/messages:search":{"get":{"operationId":"searchMessages","x-receive-only":true,"x-zeromail-capability":{"id":"mail.messages.search","version":1,"receive_only":true,"free":true}}},"/v1/mailboxes/{id}/subscriptions":{"post":{"operationId":"createSubscription","x-receive-only":true,"x-zeromail-capability":{"id":"mail.subscriptions.create","version":1,"receive_only":true,"free":true}},"get":{"operationId":"listSubscriptions","x-receive-only":true}},"/v1/mailboxes/{id}/subscriptions/{subId}":{"get":{"operationId":"getSubscription","x-receive-only":true},"delete":{"operationId":"deleteSubscription","x-receive-only":true}},"/v1/mailboxes/{id}/stream":{"get":{"operationId":"streamEvents","x-receive-only":true,"x-zeromail-capability":{"id":"mail.subscriptions.create","version":1,"receive_only":true,"free":true}}},"/v1/handles/check":{"get":{"operationId":"checkHandle","x-receive-only":true}}}}