messages

Cancel messages that have not gone out

Cancel a message that has not gone out: a failed send, or a queued one the provider has not taken yet, is canceled and leaves the thread. Nothing is sent or deleted: the row stays. A draft awaiting approval is dismiss_messages; a row that went out is 409 message_not_cancelable; one being handed to the provider right now is 409 message_send_in_flight. An AI SDR message of a live plan cancels that plan with its other unsent messages.

Contract:

  • MCP tool cancel_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/cancel

Request

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

Request body

sidstring nullable

One message that has not gone out (failed, or queued and not taken by the provider yet) to cancel. Exactly one of sid | filter, else 422 invalid_input.

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.