Skip to main content
DELETE
Delete inbox
Required scope: INBOXES_WRITE

Behavior

Deletes the inbox and returns 204 with no body. The conversations it showed are not affected and stay on their lines. Pass the user_id query parameter to delete a teammate’s inbox. Only admins and managers of the teammate’s workspace can do that. An inbox with no source in a workspace the caller manages returns 404. An inbox that also holds lines from another workspace returns 403: only the teammate can delete it.
Deleting an inbox cannot be undone. AI assistants connected through the MCP server only delete an inbox when you ask for it.

Errors

Authorizations

Authorization
string
header
required

Path Parameters

inbox_id
string
required

Inbox ID (inb-*).

Example:

"inb-abc123"

Query Parameters

user_id
string

Act on a teammate's inbox (usr-*). The caller must be an admin or manager of that teammate's workspace, and only reaches inboxes and sources in workspaces they manage. Omit to act on your own inboxes.

Example:

"usr-abc123"

Response

Inbox deleted