Update a ticket
curl --request PATCH \
--url https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"statusId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statusCategory": "on_customer",
"assigneeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assigneeEmail": "sam@example.com",
"teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"priority": "urgent",
"agentEmail": "sam@example.com"
}
'import requests
url = "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}"
payload = {
"statusId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statusCategory": "on_customer",
"assigneeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assigneeEmail": "sam@example.com",
"teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"priority": "urgent",
"agentEmail": "sam@example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
statusId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
statusCategory: 'on_customer',
assigneeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assigneeEmail: 'sam@example.com',
teamId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
priority: 'urgent',
agentEmail: 'sam@example.com'
})
};
fetch('https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'statusId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'statusCategory' => 'on_customer',
'assigneeId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assigneeEmail' => 'sam@example.com',
'teamId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'priority' => 'urgent',
'agentEmail' => 'sam@example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}"
payload := strings.NewReader("{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"ticketNumber": 123,
"subject": "<string>",
"description": "<string>",
"statusCategory": "on_customer",
"statusId": "<string>",
"assigneeId": "<string>",
"customer": {
"id": "<string>",
"name": "Ada Lovelace",
"email": "ada@example.com",
"phoneNumber": "<string>"
},
"metadata": {
"phone_number": "+1 525-525-5255"
},
"channel": "email",
"conversationId": "<string>",
"teamId": "<string>",
"priority": "high",
"createdAt": "2026-07-20T12:34:56.000Z",
"updatedAt": "2026-07-21T09:00:00.000Z",
"lastMessageAt": "2026-07-21T08:55:00.000Z"
}Helpdesk
Update a ticket
Partially updates a ticket’s status, assignee, team, or priority. Only provided fields are changed. Fields are validated together but written independently, so a 500 can leave a partial update.
PATCH
/
agents
/
{agentId}
/
helpdesk
/
tickets
/
{ticketNumber}
Update a ticket
curl --request PATCH \
--url https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"statusId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statusCategory": "on_customer",
"assigneeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assigneeEmail": "sam@example.com",
"teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"priority": "urgent",
"agentEmail": "sam@example.com"
}
'import requests
url = "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}"
payload = {
"statusId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"statusCategory": "on_customer",
"assigneeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assigneeEmail": "sam@example.com",
"teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"priority": "urgent",
"agentEmail": "sam@example.com"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
statusId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
statusCategory: 'on_customer',
assigneeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assigneeEmail: 'sam@example.com',
teamId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
priority: 'urgent',
agentEmail: 'sam@example.com'
})
};
fetch('https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'statusId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'statusCategory' => 'on_customer',
'assigneeId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assigneeEmail' => 'sam@example.com',
'teamId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'priority' => 'urgent',
'agentEmail' => 'sam@example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}"
payload := strings.NewReader("{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.chatbase.co/api/v2/agents/{agentId}/helpdesk/tickets/{ticketNumber}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"statusId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"statusCategory\": \"on_customer\",\n \"assigneeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assigneeEmail\": \"sam@example.com\",\n \"teamId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"priority\": \"urgent\",\n \"agentEmail\": \"sam@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"ticketNumber": 123,
"subject": "<string>",
"description": "<string>",
"statusCategory": "on_customer",
"statusId": "<string>",
"assigneeId": "<string>",
"customer": {
"id": "<string>",
"name": "Ada Lovelace",
"email": "ada@example.com",
"phoneNumber": "<string>"
},
"metadata": {
"phone_number": "+1 525-525-5255"
},
"channel": "email",
"conversationId": "<string>",
"teamId": "<string>",
"priority": "high",
"createdAt": "2026-07-20T12:34:56.000Z",
"updatedAt": "2026-07-21T09:00:00.000Z",
"lastMessageAt": "2026-07-21T08:55:00.000Z"
}Authorizations
API key from your account settings
Path Parameters
The agent ID
Minimum string length:
1Example:
"5QHA6VB-DIAbBhxwqxfdi"
The ticket number
Required range:
x <= 2147483647Example:
123
Body
application/json
ID of an existing status for this agent. Provide at most one of statusId / statusCategory. Omit to leave the status unchanged.
Status category; resolves to that category's default status. Provide at most one of statusId / statusCategory. Omit to leave the status unchanged.
Available options:
new, on_you, on_customer, on_hold, closed, cancelled Example:
"on_customer"
Platform user id of the agent to assign. Provide at most one of assigneeId / assigneeEmail. Pass null to unassign the ticket. Omit to leave the assignee unchanged.
Email of the agent to assign (case-insensitive). Provide at most one of assigneeId / assigneeEmail. Does not accept null; unassign via assigneeId: null. Omit to leave the assignee unchanged.
Example:
"sam@example.com"
ID of an existing team for this agent. Pass null to clear the team. Omit to leave the team unchanged.
New ticket priority. Pass none to clear it. Omit to leave the priority unchanged.
Available options:
none, low, normal, high, urgent Example:
"urgent"
Optional. Attribute this change to the agent with this email — a member of this account (case-insensitive). If omitted, or the email is not a recognized member, the change is recorded as an automatic system change. Not itself a change: you must still provide at least one field above.
Example:
"sam@example.com"
Response
The updated ticket
The ticket number
Example:
123
Ticket subject
Ticket description
Status category driving color/ordering semantics
Available options:
new, on_you, on_customer, on_hold, closed, cancelled Example:
"on_customer"
ID of the ticket status. Resolve label/color via /ticket-statuses.
ID of the assigned agent user, or null when unassigned
Show child attributes
Show child attributes
Arbitrary extra fields captured on the ticket
Show child attributes
Show child attributes
Example:
{ "phone_number": "+1 525-525-5255" }
Channel the ticket originated from
Available options:
helpdesk, iframe, email, whatsapp, api, messenger, instagram, center_stage, phone, instagram_comment, facebook_comment Example:
"email"
ID of the linked conversation, if any
ID of the assigned team, or null. Resolve via /teams.
Ticket priority. none means the ticket has not been triaged.
Available options:
none, low, normal, high, urgent Example:
"high"
ISO 8601 creation timestamp
Example:
"2026-07-20T12:34:56.000Z"
ISO 8601 timestamp of the last update
Example:
"2026-07-21T09:00:00.000Z"
ISO 8601 timestamp of the most recent message, or null if the ticket has no messages
Example:
"2026-07-21T08:55:00.000Z"