Update a conversation

PATCH 
/inbox/conversations/:id

Changes the status (close, reopen, set pending, snooze until snoozedUntil), assigns it to a team member or pauses automations for 30 days. Each change becomes a line in the conversation. Closing and assigning fire conversation.closed and conversation.assigned.

Request

Responses

200

Record found.

401

Missing, malformed, unknown or revoked token (authentication), or a suspended account (tenant_inactive).

402

No entitlement (payment_required). The body carries the reason in reason and the way out in action: what to do (kind) and the dashboard page where it is done (url).

404

Resource does not exist (not_found).

422

Invalid body — including no change at all (invalid_request) — or the person does not handle this number (assignee_invalid).

429

Rate limit exceeded (rate_limit).

Response Headers

Retry-After

Seconds to wait before retrying.

X-RateLimit-Category

Which rate limit category applied — send, media or default.

X-RateLimit-Scope

Which bucket the other headers describe — key (the API key), session (the dashboard) or account (the account ceiling).

X-RateLimit-Limit

Request ceiling for this category in the current window.

X-RateLimit-Remaining

Requests left in the current window.