POST
Redraft Email Batch Recipients

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

batch_id
string<uuid>
required

Body

application/json

Draft these rows again, from scratch.

One verb for "write this row again", whatever put it in the state it is in — a failed attempt, a prompt that has since improved, a draft nobody liked. Four selections, and they differ in what they REFUSE as much as in what they move, because a redraft discards a draft the tenant has already paid for:

  • all — every row in the batch. Rows already sent or mid-send come back in rejected, by name, so a bulk press cannot quietly do less than it said.
  • failed — rows whose drafting failed.
  • not_sent — every row that has not left, with nothing rejected.
  • stale_version — rows drafted by a task version older than the one published now. The selection that makes "watch the output, improve the task, publish, redraft the rest" a workflow rather than a wish.
clear_overrides
boolean
default:false

Also discard the cells a person edited by hand. Off by default.

recipient_ids
string<uuid>[] | null
selection
enum<string> | null
Available options:
all,
failed,
not_sent,
stale_version

Response

Successful Response

Skip-and-report, never a partial silent accept.

affected
integer
required
rejected
RejectedRecipient · object[]
required