get_draft_status
Reads a single draft's delivery status after sending an iMessage, letting you confirm queued, held, blocked, sent, cancelled, or failed delivery and inspect hold or error details.
Instructions
Read a single draft. Use this after send_imessage to confirm the message was delivered. The response includes status — queued (waiting for the Mac), sending, held (parked by the new-outreach limit — rolling 24h window; resumes automatically as earlier sends age out or when the user raises the limit — NOT a failure), blocked (hold.reason: subscription_required or recipient_opted_out; never auto-retried), sent, cancelled, failed — plus hold (reason/since/message), sent, sendError (failed/cancelled only), and sentMessage (Firestore doc path of the dispatched message).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"draft_id": "<draft_id>"
},
"name": "get_draft_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | Draft id returned from send_imessage. |