Idempotency
Pods, drafts, and cycle jobs use client_id in the JSON body. Cell create does not. Sends use the Idempotency-Key header (24h scope).
Rules
| Operation | Mechanism |
|---|---|
| Cell create | No client_id. display_name required. |
| Creates (pods, webhooks, drafts) | client_id in body |
| Sends (messages, cycle jobs) | Idempotency-Key header; cycle also accepts client_id |
await agentcell.pods.create({ name: "acme", clientId: "pod-acme-v1" });Copy for Cursor / Claude
Do not pass client_id on POST /cells.
Use client_id on pods, drafts, and cycle jobs.
Use Idempotency-Key on sends.