# Read Me Read Me is a reading inbox filled by AI agents. When an agent finishes a plan, a report, or anything else worth reading carefully, it sends the document here — addressed to a person by phone number — and the document arrives in that person's inbox in the Read Me app for iPhone, iPad, and Mac. **If you are a person:** sign in to the Read Me app with your phone number, then tell your agent to *"send it to me through readme.computer"*. The first time a new agent sends you something, the app asks whether to accept documents from it — nothing appears in your inbox without your approval. **If you are an agent:** everything you need is on this page. (Fetching it without a browser `Accept` header returns plain markdown — what you are reading *is* the documentation.) ## Sending documents, for agents Register once, keep the token, and send documents whenever your person asks. The API lives at `https://api.readme.computer`. ### 1. Register ```sh curl -X POST https://api.readme.computer/agent/v1/register \ -H "content-type: application/json" \ -d '{"name": "", "owner": "", "ownerPhone": ""}' ``` The response echoes the phone number it bound to — read it back to your person to catch typos — and returns an `agentToken`. Save the token somewhere durable (a project file, your memory): it is not retrievable later, and it is the only credential you need. The phone number requires a `+countrycode` prefix; separators like spaces, dashes, and parentheses are fine. ### 2. Send a document ```sh curl -X POST https://api.readme.computer/agent/v1/documents \ -H "authorization: Bearer " \ -H "content-type: application/json" \ -d '{"markdown": "# Title\n\nBody…", "filename": "plan.md", "externalId": ""}' ``` Raw `text/markdown` or `text/plain` bodies also work; documents cap at 10 MB. Give each document a stable `externalId` (a content hash works well) — re-sending the same `externalId` returns success without creating a duplicate, so retries are always safe. ### What the responses mean A `202` always means you are done: the document was either delivered or is waiting for your person to approve you in the app. The response is deliberately identical in both cases. If your first documents don't show up, ask your person to open Read Me and accept you — everything you sent while pending is released the moment they do. A `401` means your token was never issued or has been purged — register again and ask to be re-approved. An unapproved registration expires after 7 days, together with anything it sent. ### Limits Pending (not-yet-approved) agents are capped at 3 per phone number, and each may hold at most 10 documents / 20 MB until approved. Approved agents are uncapped. Registrations are limited to 10 per IP per day. --- This page is served as markdown to agents and as HTML to browsers from the same document. [About](/about) · [Privacy Policy](/privacy) · [Terms of Use](/terms)