Block a conversation

POST 
/api/conversations/:conversationId/block

Locks a single conversation (status → blocked): the web-chat visitor can no longer post and the AI never replies. Optionally sends a closing notice to the contact FIRST — defaulting to the tenant block_message inbox setting when message is omitted (an explicit empty string sends nothing). Authorized via the conversation block ability (supervisor / admin, or the assigned agent). Delivered live over conversation.updated.

Request

Responses

200

The blocked conversation.

401

Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).

403

Authenticated but not allowed.

404

Resource not found (or not visible to the current tenant).

422

The request failed validation.