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

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

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'
  ]),
  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}")

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

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>",
  "createdAt": "2026-07-20T12:34:56.000Z",
  "updatedAt": "2026-07-21T09:00:00.000Z",
  "lastMessageAt": "2026-07-21T08:55:00.000Z"
}

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

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

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'
  ]),
  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}")

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

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>",
  "createdAt": "2026-07-20T12:34:56.000Z",
  "updatedAt": "2026-07-21T09:00:00.000Z",
  "lastMessageAt": "2026-07-21T08:55:00.000Z"
}

Authorizations

Authorization

string

header

required

API key from your account settings

Path Parameters

agentId

string

required

The agent ID

Minimum string length: 1

Example:

"5QHA6VB-DIAbBhxwqxfdi"

ticketNumber

integer

required

The ticket number

Required range: x <= 2147483647

Example:

123

Body

application/json

statusId

string<uuid>

ID of an existing status for this agent. Provide at most one of statusId / statusCategory. Omit to leave the status unchanged.

statusCategory

enum<string>

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"

assigneeId

string<uuid> | null

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.

assigneeEmail

string<email>

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"

teamId

string<uuid> | null

ID of an existing team for this agent. Pass null to clear the team. Omit to leave the team unchanged.

Response

The updated ticket

ticketNumber

integer

required

The ticket number

Example:

123

subject

string | null

required

Ticket subject

description

string | null

required

Ticket description

statusCategory

enum<string>

required

Status category driving color/ordering semantics

Available options:

new,

on_you,

on_customer,

on_hold,

closed,

cancelled

Example:

"on_customer"

statusId

string

required

ID of the ticket status. Resolve label/color via /ticket-statuses.

assigneeId

string | null

required

ID of the assigned agent user, or null when unassigned

customer

object

required

Show child attributes

metadata

object

required

Arbitrary extra fields captured on the ticket

Show child attributes

Example:

{ "phone_number": "+1 525-525-5255" }

channel

enum<string>

required

Channel the ticket originated from

Available options:

helpdesk,

iframe,

email,

whatsapp,

api,

messenger,

instagram,

center_stage,

phone

Example:

"email"

conversationId

string | null

required

ID of the linked conversation, if any

teamId

string | null

required

ID of the assigned team, or null. Resolve via /teams.

createdAt

string

required

ISO 8601 creation timestamp

Example:

"2026-07-20T12:34:56.000Z"

updatedAt

string

required

ISO 8601 timestamp of the last update

Example:

"2026-07-21T09:00:00.000Z"

lastMessageAt

string | null

required

ISO 8601 timestamp of the most recent message, or null if the ticket has no messages

Example:

"2026-07-21T08:55:00.000Z"

Getting Started

Endpoints

Update a ticket

Authorizations

Path Parameters

Body

Response