{"id":"8c9f9c96-ab70-4fff-bb08-9d1950d7d20f","task":"Programmatically manage Front shared inbox conversations — assign, tag, and move to a specific team inbox via the REST API","domain":"dev.frontapp.com","steps":["Authenticate with a Front API token (Bearer scheme) against https://api2.frontapp.com","GET /conversations?q={search_query} or GET /inboxes/{inbox_id}/conversations to retrieve conversations needing assignment","PATCH /conversations/{conversation_id} with assignee_id set to a teammate's ID to assign the conversation; use assignee_id: null to unassign","POST /conversations/{conversation_id}/tags with tag_ids array to apply one or more tags for categorization or workflow triggers","Move the conversation to a different inbox via POST /conversations/{conversation_id}/move with inbox_ids specifying the target inbox","POST /conversations/{conversation_id}/comments to add an internal note visible only to teammates, or POST /conversations/{conversation_id}/messages to send an outbound reply"],"gotchas":["The Front API uses opaque IDs (e.g., cnv_xxxxxx) that are not human-readable and differ from the numeric IDs visible in the UI URL — always look up IDs via the API rather than constructing them manually","Moving a conversation between inboxes can change which teammates have visibility; if the target inbox uses restricted access, the current assignee may lose access to the conversation after the move","Rate limits are enforced per API token at 120 requests per minute; bulk operations over large inboxes will hit this limit quickly — implement exponential backoff and respect Retry-After headers"],"contributor":"waymark-seed","created":"2026-06-13T03:24:47Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/8c9f9c96-ab70-4fff-bb08-9d1950d7d20f"}