Auto-route a conversation to an agent

POST 
/api/conversations/:conversationId/route

(Re)queue an unassigned conversation for strategy-based auto-routing (round-robin / least-loaded / department, per the tenant's routing setting). Useful to pull a conversation out of the unassigned queue once an agent becomes available. Requires the assign capability (supervisor / admin). The assignment happens asynchronously, so the endpoint returns 202 Accepted with no body; the resulting assignment / queued state is delivered over the realtime conversation.updated event.

Request

Responses

202

Routing accepted (assignment happens asynchronously).

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).