Connect your agent

One short code, and every transcript waits in a small inbox until your agent picks it up.

Pairing

In Ramble on your iPhone, open Settings → Connect agent and pick your agent.
Tell your agent “I downloaded Ramble, connect it” and paste the code (like K7QX-MP4D). It works once and expires in 10 minutes.
Talk to your watch. Your agent picks up each one and gets to work.

Your agent can only pick up your transcripts. Tap Disconnect on the same screen to cut it off; anything still waiting is deleted.

Instructions for the agent

This is the whole loop. If your agent asks how the connection works, paste this in.

Paste to your agent

Ramble connection
Relay: https://ramble-transcription-proxy.jpoliachik.workers.dev

1. When I say "I downloaded Ramble, connect it" and give you a code like K7QX-MP4D,
   POST {"code": "<the code>"} to /pair/exchange. Save the returned "token" as a secret.
2. GET /inbox with the header
   Authorization: Bearer <token>
   Check as often as you can, using whatever way of running recurring work suits you
   best. It's a tiny request that usually returns an empty list, so frequent checks are fine.
3. For each item, do what I asked in "transcription".
4. POST {"ids": [...]} to /inbox/ack with the ids you handled. If "has_more" is true, pull again.
5. If a request returns 401, I disconnected you. Stop checking and tell me.

API

Three JSON calls. A pull returns up to 50 items, oldest first. Acking deletes them; if has_more is true, pull again. Anything never acked is deleted after 30 days. Every path is relative to https://ramble-transcription-proxy.jpoliachik.workers.dev.

POST /pair/exchange
{"code": "K7QX-MP4D"}
→ {"token": "rmba_…"}

GET /inbox
Authorization: Bearer rmba_…
→ {"items": [{"id": 41, "recording_id": "6F1C…", "created_at": "2026-11-01T19:00:00Z",
              "duration": 8.2, "transcription": "Remind me to book the dentist."}],
   "has_more": false}

POST /inbox/ack
Authorization: Bearer rmba_…
{"ids": [41]}
→ {"deleted": 1}

What the relay stores and for how long is in the privacy policy. To send transcripts to your own server instead, see Webhooks.