Sign in

v51

latestOpenAPI 3.0.1MITraw.githubusercontent.com2026-08-01150230854.3 KB
Ticket Types

Update a ticket type

You can update a ticket type.

📘 Updating a ticket type.

For the icon propery, use an emoji from Twemoji Cheatsheet

put/ticket_types/{ticket_type_id}

Path parameters

ticket_type_idstring required

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

Headers

Intercom-Version'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' | '2.11' | '2.12' | '2.13' | '2.14'

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

Example:2.14

Request body

namestring

The name of the ticket type.

descriptionstring

The description of the ticket type.

category'Customer' | 'Back-office' | 'Tracker'

Category of the Ticket Type.

iconstring

The icon of the ticket type.

archivedboolean

The archived status of the ticket type.

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.

Example request

{
  "name": "Bug",
  "description": "A bug has been occured",
  "category": "Customer",
  "icon": "🐞"
}

Response

Ticket type updated

typestring

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

idstring

The id representing the ticket type.

category'Customer' | 'Back-office' | 'Tracker'

Category of the Ticket Type.

namestring

The name of the ticket type

descriptionstring

The description of the ticket type

iconstring

The icon of the ticket type

workspace_idstring

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

archivedboolean

Whether the ticket type is archived or not.

created_atinteger

The date and time the ticket type was created.

updated_atinteger

The date and time the ticket type was last updated.

Example response

{
  "type": "ticket_type",
  "id": "1295",
  "category": "Customer",
  "name": "Bug",
  "description": "A bug that has been reported.",
  "icon": "🐞",
  "workspace_id": "ecahpwf5",
  "ticket_type_attributes": {
    "ticket_type_attributes": [
      {
        "type": "ticket_type_attribute",
        "id": "1",
        "workspace_id": "ecahpwf5",
        "name": "Title",
        "description": "Bug title.",
        "data_type": "string",
        "order": 1,
        "default": true,
        "ticket_type_id": 42
      }
    ]
  },
  "ticket_states": {
    "type": "list",
    "data": [
      {
        "type": "ticket_state",
        "id": "12",
        "category": "in_progress",
        "internal_label": "With Dev Team",
        "external_label": "In Progress"
      }
    ]
  }
}