messages

Dismiss message drafts

Reject AI SDR drafts: pending_approval becomes canceled. Nothing is sent or deleted, the row stays for audit and the dismissal feeds the learning loop. One sid or a filter (state pending_approval ANDed in); reason is a note never shown to the counterpart. Any other state is 409 message_not_editable; result.dismissed_count says how many moved. To rewrite a draft instead, regenerate_message.

Contract:

  • MCP tool dismiss_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/dismiss

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 reject. Exactly one of sid | filter, else 422 invalid_input.

reasonstring nullable

Why it was rejected, max 255. Stored for the learning loop; it is not sent anywhere and not shown to the counterpart.

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.