Intercom API (unofficial showcase)
DELETE/tickets/{ticket_id}

Delete a ticket

Deletes a ticket permanently from the inbox, including its replies, attributes, uploads, and related content.

Deleting a ticket is permanent and cannot be reversed.
The ticket remains in reporting, although some reporting data may be incomplete.

2 parameters
ticket_idstringrequired
The ticket's unique internal API identifier. Use the ticket object's `id`, not the `ticket_id` shown in the Inbox.
Intercom-Versionstringoptional
The Intercom 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

4 status codes
200Returns the deleted ticket object, including its identifier and a `deleted` value indicating whether it was deleted.
idstringoptional
The unique identifier for the ticket.
objectstringoptional
always ticket
Allowed:ticket
deletedbooleanoptional
Whether the ticket is deleted or not.
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
403Returned when the API plan restricts ticket deletion.

One documented failure

  • api_plan_restricted

    Active subscription needed.

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the ticket is not found.

One documented failure

  • ticket_not_found

    Ticket not found

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. A 403 is returned when the API plan restricts this operation, and a 404 is returned when the ticket is not found. The ticket_id path parameter must be the ticket's internal API identifier, not its Inbox ID.