> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom: Update Ticket Type

> Update an Intercom ticket type's name, description, category, icon, or archive it. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Update an Intercom ticket type's name, description, category, icon, or archive it.

> [!NOTE]
>
> Tool ID: `intercom_update_ticket_type`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'intercom_update_ticket_type',
  {
    "ticket_type_id": "ticket_type_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute intercom_update_ticket_type --input '{
  "ticket_type_id": "ticket_type_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "type": "example",
    "id": "id_123",
    "category": "Customer"
  }
}
```

Use `deepline describe intercom_update_ticket_type --json` for the latest machine-readable contract.

## Input reference

The request payload for updating a ticket type. You can copy the `icon` property for your ticket type from [Twemoji Cheatsheet](https://twemoji-cheatsheet.vercel.app/)

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.ticket_type_id` | `string` | Yes | — | The unique identifier for the ticket type which is given by Intercom. |
| `payload.name` | `string` | No | — | The name of the ticket type. |
| `payload.description` | `string` | No | — | The description of the ticket type. |
| `payload.category` | `"Customer" \| "Back-office" \| "Tracker"` | No | — | Category of the Ticket Type. Allowed: `Customer`, `Back-office`, `Tracker`. |
| `payload.icon` | `string` | No | `"🎟️"` | The icon of the ticket type. |
| `payload.archived` | `boolean` | No | — | The archived status of the ticket type. |
| `payload.is_internal` | `boolean` | No | `false` | 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. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "The request payload for updating a ticket type. You can copy the `icon` property for your ticket type from [Twemoji Cheatsheet](https://twemoji-cheatsheet.vercel.app/)",
    "properties": {
      "ticket_type_id": {
        "type": "string",
        "description": "The unique identifier for the ticket type which is given by Intercom."
      },
      "name": {
        "type": "string",
        "description": "The name of the ticket type."
      },
      "description": {
        "type": "string",
        "description": "The description of the ticket type."
      },
      "category": {
        "type": "string",
        "description": "Category of the Ticket Type.",
        "enum": [
          "Customer",
          "Back-office",
          "Tracker"
        ]
      },
      "icon": {
        "type": "string",
        "description": "The icon of the ticket type.",
        "default": "🎟️"
      },
      "archived": {
        "type": "boolean",
        "description": "The archived status of the ticket type."
      },
      "is_internal": {
        "type": "boolean",
        "description": "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
      }
    },
    "required": [
      "ticket_type_id"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | A ticket type, used to define the data fields to be captured in a ticket. |
| `result.data.type` | `string` | No | — | String representing the object's type. Always has the value `ticket_type`. |
| `result.data.id` | `string` | No | — | The id representing the ticket type. |
| `result.data.category` | `"Customer" \| "Back-office" \| "Tracker"` | No | — | Category of the Ticket Type. Allowed: `Customer`, `Back-office`, `Tracker`. |
| `result.data.name` | `string` | No | — | The name of the ticket type |
| `result.data.description` | `string` | No | — | The description of the ticket type |
| `result.data.icon` | `string` | No | — | The icon of the ticket type |
| `result.data.workspace_id` | `string` | No | — | The id of the workspace that the ticket type belongs to. |
| `result.data.ticket_type_attributes` | `object` | No | — | A list of attributes associated with a given ticket type. |
| `result.data.ticket_type_attributes.type` | `string` | No | — | String representing the object's type. Always has the value `ticket_type_attributes.list`. |
| `result.data.ticket_type_attributes.ticket_type_attributes` | `array` | No | — | A list of ticket type attributes associated with a given ticket type. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].type` | `string` | No | — | String representing the object's type. Always has the value `ticket_type_attribute`. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].id` | `string` | No | — | The id representing the ticket type attribute. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].workspace_id` | `string` | No | — | The id of the workspace that the ticket type attribute belongs to. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].name` | `string` | No | — | The name of the ticket type attribute |
| `result.data.ticket_type_attributes.ticket_type_attributes[].description` | `string` | No | — | The description of the ticket type attribute |
| `result.data.ticket_type_attributes.ticket_type_attributes[].data_type` | `string` | No | — | The type of the data attribute (allowed values: "string list integer decimal boolean datetime files") |
| `result.data.ticket_type_attributes.ticket_type_attributes[].input_options` | `record` | No | — | Input options for the attribute |
| `result.data.ticket_type_attributes.ticket_type_attributes[].order` | `integer` | No | — | The order of the attribute against other attributes |
| `result.data.ticket_type_attributes.ticket_type_attributes[].required_to_create` | `boolean` | No | `false` | Whether the attribute is required or not for teammates. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].required_to_create_for_contacts` | `boolean` | No | `false` | Whether the attribute is required or not for contacts. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].visible_on_create` | `boolean` | No | `true` | Whether the attribute is visible or not to teammates. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].visible_to_contacts` | `boolean` | No | `true` | Whether the attribute is visible or not to contacts. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].default` | `boolean` | No | — | Whether the attribute is built in or not. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].ticket_type_id` | `integer` | No | — | The id of the ticket type that the attribute belongs to. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].archived` | `boolean` | No | — | Whether the ticket type attribute is archived or not. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].created_at` | `integer` | No | — | The date and time the ticket type attribute was created. Format: `timestamp`. |
| `result.data.ticket_type_attributes.ticket_type_attributes[].updated_at` | `integer` | No | — | The date and time the ticket type attribute was last updated. Format: `timestamp`. |
| `result.data.ticket_states` | `object` | No | — | A list of ticket states associated with a given ticket type. |
| `result.data.ticket_states.type` | `string` | No | — | String representing the object's type. Always has the value `list`. |
| `result.data.ticket_states.data` | `array` | No | — | A list of ticket states associated with a given ticket type. |
| `result.data.ticket_states.data[].type` | `string` | No | — | String representing the object's type. Always has the value `ticket_state`. |
| `result.data.ticket_states.data[].id` | `string` | No | — | The id of the ticket state |
| `result.data.ticket_states.data[].category` | `"submitted" \| "in_progress" \| "waiting_on_customer" \| "resolved"` | No | — | The category of the ticket state Allowed: `submitted`, `in_progress`, `waiting_on_customer`, `resolved`. |
| `result.data.ticket_states.data[].internal_label` | `string` | No | — | The state the ticket is currently in, in a human readable form - visible in Intercom |
| `result.data.ticket_states.data[].external_label` | `string` | No | — | The state the ticket is currently in, in a human readable form - visible to customers, in the messenger, email and tickets portal. |
| `result.data.archived` | `boolean` | No | — | Whether the ticket type is archived or not. |
| `result.data.created_at` | `integer` | No | — | The date and time the ticket type was created. Format: `timestamp`. |
| `result.data.updated_at` | `integer` | No | — | The date and time the ticket type was last updated. Format: `timestamp`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": [
          "object",
          "null"
        ],
        "description": "A ticket type, used to define the data fields to be captured in a ticket.",
        "properties": {
          "type": {
            "type": "string",
            "description": "String representing the object's type. Always has the value `ticket_type`."
          },
          "id": {
            "type": "string",
            "description": "The id representing the ticket type."
          },
          "category": {
            "type": "string",
            "description": "Category of the Ticket Type.",
            "enum": [
              "Customer",
              "Back-office",
              "Tracker"
            ]
          },
          "name": {
            "type": "string",
            "description": "The name of the ticket type"
          },
          "description": {
            "type": "string",
            "description": "The description of the ticket type"
          },
          "icon": {
            "type": "string",
            "description": "The icon of the ticket type"
          },
          "workspace_id": {
            "type": "string",
            "description": "The id of the workspace that the ticket type belongs to."
          },
          "ticket_type_attributes": {
            "type": "object",
            "description": "A list of attributes associated with a given ticket type.",
            "properties": {
              "type": {
                "type": "string",
                "description": "String representing the object's type. Always has the value `ticket_type_attributes.list`."
              },
              "ticket_type_attributes": {
                "type": "array",
                "description": "A list of ticket type attributes associated with a given ticket type.",
                "items": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "Ticket type attribute, used to define each data field to be captured in a ticket.",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "String representing the object's type. Always has the value `ticket_type_attribute`."
                    },
                    "id": {
                      "type": "string",
                      "description": "The id representing the ticket type attribute."
                    },
                    "workspace_id": {
                      "type": "string",
                      "description": "The id of the workspace that the ticket type attribute belongs to."
                    },
                    "name": {
                      "type": "string",
                      "description": "The name of the ticket type attribute"
                    },
                    "description": {
                      "type": "string",
                      "description": "The description of the ticket type attribute"
                    },
                    "data_type": {
                      "type": "string",
                      "description": "The type of the data attribute (allowed values: \"string list integer decimal boolean datetime files\")"
                    },
                    "input_options": {
                      "type": "object",
                      "description": "Input options for the attribute"
                    },
                    "order": {
                      "type": "integer",
                      "description": "The order of the attribute against other attributes"
                    },
                    "required_to_create": {
                      "type": "boolean",
                      "description": "Whether the attribute is required or not for teammates.",
                      "default": false
                    },
                    "required_to_create_for_contacts": {
                      "type": "boolean",
                      "description": "Whether the attribute is required or not for contacts.",
                      "default": false
                    },
                    "visible_on_create": {
                      "type": "boolean",
                      "description": "Whether the attribute is visible or not to teammates.",
                      "default": true
                    },
                    "visible_to_contacts": {
                      "type": "boolean",
                      "description": "Whether the attribute is visible or not to contacts.",
                      "default": true
                    },
                    "default": {
                      "type": "boolean",
                      "description": "Whether the attribute is built in or not."
                    },
                    "ticket_type_id": {
                      "type": "integer",
                      "description": "The id of the ticket type that the attribute belongs to."
                    },
                    "archived": {
                      "type": "boolean",
                      "description": "Whether the ticket type attribute is archived or not."
                    },
                    "created_at": {
                      "type": "integer",
                      "description": "The date and time the ticket type attribute was created.",
                      "format": "timestamp"
                    },
                    "updated_at": {
                      "type": "integer",
                      "description": "The date and time the ticket type attribute was last updated.",
                      "format": "timestamp"
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          },
          "ticket_states": {
            "type": "object",
            "description": "A list of ticket states associated with a given ticket type.",
            "properties": {
              "type": {
                "type": "string",
                "description": "String representing the object's type. Always has the value `list`."
              },
              "data": {
                "type": "array",
                "description": "A list of ticket states associated with a given ticket type.",
                "items": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "A ticket state, used to define the state of a ticket.",
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "String representing the object's type. Always has the value `ticket_state`."
                    },
                    "id": {
                      "type": "string",
                      "description": "The id of the ticket state"
                    },
                    "category": {
                      "type": "string",
                      "description": "The category of the ticket state",
                      "enum": [
                        "submitted",
                        "in_progress",
                        "waiting_on_customer",
                        "resolved"
                      ]
                    },
                    "internal_label": {
                      "type": "string",
                      "description": "The state the ticket is currently in, in a human readable form - visible in Intercom"
                    },
                    "external_label": {
                      "type": "string",
                      "description": "The state the ticket is currently in, in a human readable form - visible to customers, in the messenger, email and tickets portal."
                    }
                  },
                  "additionalProperties": false
                }
              }
            },
            "additionalProperties": false
          },
          "archived": {
            "type": "boolean",
            "description": "Whether the ticket type is archived or not."
          },
          "created_at": {
            "type": "integer",
            "description": "The date and time the ticket type was created.",
            "format": "timestamp"
          },
          "updated_at": {
            "type": "integer",
            "description": "The date and time the ticket type was last updated.",
            "format": "timestamp"
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Intercom provider guide](https://deepline.com/docs/providers/intercom/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.