Drafts

Drafts are the human-in-the-loop path: the agent proposes an SMS, a human approves, then the agent sends.

Organization

Parent

Cell

Parent

Draft

This guide

Create and send

Create a draft on a cell, optionally in reply to a message. Sending a draft is a separate call so approval can happen in the console or via API.

const draft = await agentcell.drafts.create({
  cellId, to: "+14155550144", body: "Need a human to approve this.", clientId: "draft-1",
});
await agentcell.drafts.send({ cellId, draftId: draft.id });

Console is read-only

Humans observe drafts in the console; sending still happens through API, MCP, or CLI.

Console login guide

Common errors

VALIDATION_ERROR
Draft body or recipient missing.

Copy for Cursor / Claude

Create a draft, wait for approval, then send.

agentcell cells drafts create --cell-id $CELL_ID --to +14155550144 --body "Need approval"
agentcell cells drafts send --cell-id $CELL_ID --draft-id $DRAFT_ID