GEgetsales
messages

Approve message drafts

Release AI SDR drafts to the send queue: pending_approval becomes queued, dispatched at scheduled_at. One sid or a filter; body, subject and scheduled_at are inline edits for one sid only. Any other state is 409 message_not_editable. A draft whose reason is gone is withdrawn instead (409 message_superseded on one sid; the filter arm skips it); a sender down is 409 sender_unavailable, the draft stays pending.

Contract:

  • MCP tool approve_messages, registry package mcp.unibox/messages, mount unibox.inbox.
  • Operation action, response envelope action.
  • Flags: dangerous: the MCP layer gates it behind a preview/commit token, and the effect cannot be undone through this API; mass action: this verb's own request accepts a filter or targets[] set, which the owning service drains.
post/api/messages/approve

Request

  • Base URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

sidstring nullable

One draft to approve. Exactly one of sid | filter, else 422 invalid_input.

bodystring nullable

Inline edit of the text before it queues, min 1 char. SINGLE-SID MODE ONLY: sending it with filter is a 422.

subjectstring nullable

Inline edit of the email subject, max 998. Single-sid mode only.

scheduled_atstring nullable

ISO 8601 UTC send time for this approval, overriding the draft's. Single-sid mode only.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

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