Skip to main content
POST
/
platform-api
/
v1
/
chats
/
assign
Assign ticket
curl --request POST \
  --url https://app.sagepilot.ai/platform-api/v1/chats/assign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ticket_id": "<string>",
  "assignee_type": "<string>"
}
'
{
  "success": true,
  "chat": {
    "id": "0e14f204-0f57-4a8d-a105-4e38982238b2",
    "workspace_id": "ab1360ce-ef91-4397-8fbd-3ed77ef80e08",
    "status": "open",
    "sub_status": null,
    "priority": "",
    "last_message_created_at": "2026-05-29T16:49:38+00:00",
    "pilot_id": null,
    "agent_id": null,
    "created_at": "2026-05-29T16:49:32.959247+00:00",
    "updated_at": "2026-05-29T16:55:57.987982+00:00",
    "assignee_type": "agent",
    "code": "1143",
    "unread_status": false,
    "subject": null,
    "summary": null,
    "channel_id": "47ef5902-f2c8-4b97-97d9-fb9b1ba585f5",
    "team_id": null,
    "queue_status": null,
    "closed_at": null,
    "customers": {
      "id": "12290791-dcd4-464f-a2a3-79dce74d01e4",
      "name": "anushka.pawar",
      "phone": null,
      "email": "[email protected]",
      "company": "sagepilot.ai",
      "instagram_username": null
    },
    "channels": {
      "id": "47ef5902-f2c8-4b97-97d9-fb9b1ba585f5",
      "name": "New Playground Channel",
      "kind": "playground"
    },
    "chat_tags": [],
    "chat_custom_field_values": []
  }
}

{
  "success": true,
  "chat": {
    "id": "0e14f204-0f57-4a8d-a105-4e38982238b2",
    "workspace_id": "ab1360ce-ef91-4397-8fbd-3ed77ef80e08",
    "status": "open",
    "sub_status": null,
    "priority": "",
    "last_message_created_at": "2026-05-29T16:49:38+00:00",
    "pilot_id": null,
    "agent_id": null,
    "created_at": "2026-05-29T16:49:32.959247+00:00",
    "updated_at": "2026-05-29T16:55:57.987982+00:00",
    "assignee_type": "agent",
    "code": "1143",
    "unread_status": false,
    "subject": null,
    "summary": null,
    "channel_id": "47ef5902-f2c8-4b97-97d9-fb9b1ba585f5",
    "team_id": null,
    "queue_status": null,
    "closed_at": null,
    "customers": {
      "id": "12290791-dcd4-464f-a2a3-79dce74d01e4",
      "name": "anushka.pawar",
      "phone": null,
      "email": "[email protected]",
      "company": "sagepilot.ai",
      "instagram_username": null
    },
    "channels": {
      "id": "47ef5902-f2c8-4b97-97d9-fb9b1ba585f5",
      "name": "New Playground Channel",
      "kind": "playground"
    },
    "chat_tags": [],
    "chat_custom_field_values": []
  }
}
Assign a ticket to a human agent, AI agent, team queue, or unassigned state.

​
Required access

AuthenticationScopeDataset grant
API client v2tickets:assigntickets

​
Body

​
ticket_id
string
required
Ticket chat UUID to assign. Use the records[].id value from List tickets; do not pass the human-readable ticket code.
​
assignee_type
string
required
Assignment type. Supported values are agent, pilot, team, and unassigned. Use agent for a human agent, pilot for an AI agent, team for a team queue, and unassigned to clear assignment.
​
assignee_id
string
Assignee UUID. Required for agent, pilot, and team assignments. For assignee_type: "pilot", use an AI agent ID. For assignee_type: "agent", use a human agent ID. For assignee_type: "team", use the team ID. Omit this field for unassigned. See Resource IDs.

​
Response

​
success
boolean
required
Whether the assignment succeeded.
​
chat
object
required
Updated ticket chat object.