Update a ticket

You can update a ticket.

SecurityHTTP: bearerAuth
Request
path Parameters
id
required
string

The unique identifier for the ticket which is given by Intercom

header Parameters
Intercom-Version
string (intercom_version)
Default: 2.10

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "1.0" "1.1" "1.2" "1.3" "1.4" "2.0" "2.1" "2.2" "2.3" "2.4" "2.5" "2.6" "2.7" "2.8" "2.9" "2.10" "Unstable"
Example: 2.10
Request Body schema: application/json
ticket_attributes
object

The attributes set on the ticket.

state
string

The state of the ticket.

Enum: "in_progress" "waiting_on_customer" "resolved"
open
boolean

Specify if a ticket is open. Set to false to close a ticket. Closing a ticket will also unsnooze it.

is_shared
boolean

Specify whether the ticket is visible to users.

snoozed_until
integer <timestamp>

The time you want the ticket to reopen.

object
put
/tickets/{id}
Request samples
application/json
{ "state": "in_progress", "open": true, "snoozed_until": 1673609604 }
Responses

200

Successful response

Response Schema: application/json
type
string
Default: "ticket"

Always ticket

Value: "ticket"
id
string

The unique identifier for the ticket which is given by Intercom.

ticket_id
string

The ID of the Ticket used in the Intercom Inbox and Messenger. Do not use ticket_id for API queries.

category
string

Category of the Ticket.

Enum: "Customer" "Back-office" "Tracker"
object (Ticket Attributes)

An object containing the different attributes associated to the ticket as key-value pairs. For the default title and description attributes, the keys are _default_title_ and _default_description_.

ticket_state
string

The state the ticket is currenly in

Enum: "submitted" "in_progress" "waiting_on_customer" "resolved" "closed"
object or null (Ticket Type)

A ticket type, used to define the data fields to be captured in a ticket.

object (Contacts)

The list of contacts affected by a ticket.

admin_assignee_id
string

The id representing the admin assigned to the ticket.

team_assignee_id
string

The id representing the team assigned to the ticket.

created_at
integer <date-time>

The time the ticket was created as a UTC Unix timestamp.

updated_at
integer <date-time>

The last time the ticket was updated as a UTC Unix timestamp.

open
boolean

Whether or not the ticket is open. If false, the ticket is closed.

snoozed_until
integer <date-time>

The time the ticket will be snoozed until as a UTC Unix timestamp. If null, the ticket is not currently snoozed.

object (Linked Objects)

An object containing metadata about linked conversations and linked tickets. Up to 1000 can be returned.

object (Ticket Parts)

A list of Ticket Part objects for each note and event in the ticket. There is a limit of 500 parts.

is_shared
boolean

Whether or not the ticket is shared with the customer.

401

Unauthorized

404

Assignee not found

Response samples
application/json
{ "type": "ticket", "id": "732693", "ticket_id": "729519", "ticket_state": "in_progress", "admin_assignee_id": "991266700", "team_assignee_id": "0", "created_at": 1695333828, "updated_at": 1695333831, "open": true, "snoozed_until": 1695398400, "category": "Back-office", "is_shared": false }