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>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ticket_id: '<string>', assignee_type: '<string>'})
};

fetch('https://app.sagepilot.ai/platform-api/v1/chats/assign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.sagepilot.ai/platform-api/v1/chats/assign"

payload = {
    "ticket_id": "<string>",
    "assignee_type": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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": []
  }
}

POST

platform-api

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>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ticket_id: '<string>', assignee_type: '<string>'})
};

fetch('https://app.sagepilot.ai/platform-api/v1/chats/assign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.sagepilot.ai/platform-api/v1/chats/assign"

payload = {
    "ticket_id": "<string>",
    "assignee_type": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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

Authentication	Scope	Dataset grant
API client v2	`tickets:assign`	`tickets`

Body

string

required

Ticket chat UUID to assign. Use the records[].id value from List tickets; do not pass the human-readable ticket code.

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.

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

boolean

required

Whether the assignment succeeded.

object

required

Updated ticket chat object.

⌘I

Analytics

Messages

Assign ticket

Required access

Body

Response

​Required access

​Body

​Response

Required access

Body

Response