INintercom
Tickets

Delete a ticket

Changed on

{% admonition type="warning" name="Irreversible operation" %} Deleting a ticket is permanent and cannot be reversed. {% /admonition %}

Deleting a ticket permanently removes it from the inbox. All sensitive data is deleted, including admin and user replies, ticket attributes, uploads, and related content. The ticket will still appear in reporting, though some data may be incomplete due to the deletion.

delete/tickets/{ticket_id}

Request

  • Base URL
    https://api.intercom.io
  • Auth
    HTTP bearer

Path parameters

ticket_idstring required

The unique identifier for the ticket 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

Response

successful

idstring

The unique identifier for the ticket.

object'ticket'

always ticket

deletedboolean

Whether the ticket is deleted or not.

Example response

{
  "id": "5ba682d23d7cf92bef87bfd4",
  "object": "ticket",
  "deleted": true
}

Changes

  • 2.14d124ac8daf6cRevision changes
    • info

      added the non-success response with the status

    • info

      added the optional property // to the response with the status

  • 2.1421745f4700e8Revision changes
    • breaking

      added the new path request parameter ticket_id

    • warning

      deleted the path request parameter id