Update a ticket type

Request

You can update a ticket type.

📘 Updating a ticket type.
For the icon propery, use an emoji from Twemoji Cheatsheet

Security

bearerAuth

Path

ticket_type_idstringrequired

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

Intercom-Versionstring(intercom_version)

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

Default:"2.16"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:2.16

Bodyapplication/json

namestring

The name of the ticket type.

Example:"Bug"

descriptionstring

The description of the ticket type.

Example:"A bug has been occured"

categorystring

Category of the Ticket Type.

Enum:"Customer""Back-office""Tracker"

Example:"Customer"

iconstring

The icon of the ticket type.

Default:"🎟️"

Example:"🐞"

archivedboolean

The archived status of the ticket type.

Example:false

is_internalboolean

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

Example:false

curl -i -X PUT \
  'https://api.intercom.io/ticket_types/{ticket_type_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: 2.16' \
  -d '{
    "name": "Bug Report 2"
  }'

Responses

Ticket type updated

Bodyapplication/json

typestring

String representing the object's type. Always has the value ticket_type.

Example:"ticket_type"

idstring

The id representing the ticket type.

Example:"1295"

categorystring

Category of the Ticket Type.

Enum:"Customer""Back-office""Tracker"

Example:"Customer"

namestring

The name of the ticket type

Example:"Bug"

descriptionstring

The description of the ticket type

Example:"A bug that has been reported."

iconstring

The icon of the ticket type

Example:"🐞"

workspace_idstring

The id of the workspace that the ticket type belongs to.

Example:"ecahpwf5"

ticket_type_attributesobject(Ticket Type Attributes)

A list of attributes associated with a given ticket type.

ticket_statesobject(Ticket States)

A list of ticket states associated with a given ticket type.

archivedboolean

Whether the ticket type is archived or not.

Example:false

created_atinteger, (timestamp)

The date and time the ticket type was created.

updated_atinteger, (timestamp)

The date and time the ticket type was last updated.

Response

{
  "type": "ticket_type",
  "id": "74",
  "name": "Bug Report 2",
  "description": "Bug Report Template",
  "icon": "🎟️",
  "workspace_id": "this_is_an_id660_that_should_be_at_least_",
  "archived": false,
  "created_at": 1734537873,
  "updated_at": 1734537874,
  "is_internal": false,
  "ticket_type_attributes": {
    "type": "list",
    "data": [ … ]
  },
  "category": "Customer",
  "ticket_states": {
    "type": "list",
    "data": [ … ]
  }
}