agents

List Agent Drafts Page

Paginated, filterable, priority-sorted view of an agent's drafts for the review queue.

Each draft is classified (flagged / safe / uncertain) so the UI can group, sort by who needs attention, and power bulk actions — instead of the old flat 500-row, one-at-a-time list. status filters to one of pending/sent/skipped (default: all); q searches the recipient name/email; sort=priority (default) puts the highest churn-risk / revenue recipients first, sort=recent falls back to newest-first.

Recipient filters mirror the customer list (same semantics as /customers): health (repeatable, matches any), plan_tier, plan_name (repeatable; the workspace's own plan ladder, e.g. from /customers/group-counts?group_by=plan), lifecycle_stage (repeatable), min_churn_risk (inclusive) / max_churn_risk (exclusive), plus has_bug_reports / has_replied (true = at least one; via the denormalized counters). Any recipient filter implicitly drops drafts whose customer row is gone, since there is nothing to match against.

get/api/v1/agents/{agent_id}/drafts/page

Path parameters

agent_idstring uuid required

Query parameters

statusstring nullable
qstring nullable
sortstring
healthstring[] nullable
plan_tierstring nullable
plan_namestring[] nullable
lifecycle_stagestring[] nullable
min_churn_risknumber nullable
max_churn_risknumber nullable
has_bug_reportsboolean nullable
has_repliedboolean nullable
openedboolean nullable
returnedboolean nullable
pageinteger

Page number

Page number

per_pageinteger

Items per page

Items per page

Headers

authorizationstring nullable

Bearer <token>

Bearer <token>

Response

Successful Response

Changes

No recorded changes to this endpoint across all 1 revision of this API.