Setter API
The AI setter is Iron’s native setting agent. It drafts and (when enabled) handles first-touch and follow-up SMS, qualifies leads, and routes them to a call or a quote. By default it runs in suggestive mode (writes drafts a human sends) — autopilot is gated off.
The setter’s queue and assignment surface is org-scoped via X-Org-Id, under /api/v1/setter.
Endpoints
Section titled “Endpoints”| Method | Path | Description |
|---|---|---|
GET |
/setter/queue |
The setter work queue. |
GET |
/setter/queue/counts |
Queue counts (by state). |
POST |
/setter/claim-next |
Claim the next available assignment. |
GET |
/setter/stats |
Setter performance stats. |
GET |
/setter/leaderboard |
Setting leaderboard. |
GET |
/setter/assignments/{assignment_id} |
Get an assignment. |
POST |
/setter/assignments/{assignment_id}/claim |
Claim a specific assignment. |
POST |
/setter/assignments/{assignment_id}/release |
Release a claimed assignment. |
POST |
/setter/assignments/{assignment_id}/disposition |
Disposition an assignment (outcome). |
POST |
/setter/assignments/{assignment_id}/assign |
Assign to a staff member. |
Configuration
Section titled “Configuration”Setter behavior is configured per org (response mode off / suggestive / autopilot,
business / sleep hours, reply delay, and a reply_objective that selects the behavioral spine —
default setting SOP, book_call, or route_to_quote for quote-based clients with no calendar).
The config and the voice-agent config are served by the agents router:
| Method | Path | Description |
|---|---|---|
GET / PUT |
/agents/voice/config |
Voice-agent config (org-scoped). |
The setter is knowledge-base backed (see the KB routes) and emits an optional structured action in its reply. Drafts are captured for training when a human edits and sends them. See Conversations for the suggestion send / dismiss endpoints.