Intercom API (unofficial showcase)
PUT/ticket_types/{ticket_type_id}

Update a ticket type

Replaces the configurable details of an existing ticket type. Supply only the fields you want to change; category accepts Customer, Back-office, or Tracker, and omitted icon and is_internal values use their defined defaults when provided. The updated response includes the ticket type's current details.

2 parameters · 6 body fields
ticket_type_idstringrequired
The unique identifier of the ticket type to update.
Intercom-Versionstringoptional
The API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

Fields to update on the ticket type. Omit fields you do not want to change.

namestringoptional
The name of the ticket type.
descriptionstringoptional
The description of the ticket type.
categorystringoptional
Category of the Ticket Type.
Allowed:CustomerBack-officeTracker
iconstringoptional
The icon of the ticket type.
Default:🎟️
archivedbooleanoptional
The archived status of the ticket type.
is_internalbooleanoptional
Whether the tickets associated with this ticket type are intended for internal use only or will be shared with customers. This is currently a limited attribute.
Default:false

2 status codes
200Returns the updated ticket type, including its identifier, category, attributes, states, archive status, and timestamps.
typestringoptional
String representing the object's type. Always has the value `ticket_type`.
idstringoptional
The id representing the ticket type.
categorystringoptional
Category of the Ticket Type.
Allowed:CustomerBack-officeTracker
namestringoptional
The name of the ticket type
descriptionstringoptional
The description of the ticket type
iconstringoptional
The icon of the ticket type
workspace_idstringoptional
The id of the workspace that the ticket type belongs to.
ticket_type_attributesobjectoptional
A list of attributes associated with a given ticket type.
ticket_statesobjectoptional
A list of ticket states associated with a given ticket type.
archivedbooleanoptional
Whether the ticket type is archived or not.
created_atintegeroptional
The date and time the ticket type was created.
updated_atintegeroptional
The date and time the ticket type was last updated.
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is unauthorized. The ticket_type_id path parameter must identify an existing ticket type, and category must be Customer, Back-office, or Tracker when provided.