- Delete a ticket
Deleting a ticket is permanent and cannot be reversed.
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. What happens to the ticket's reporting data depends on the retain_metrics parameter:
With
retain_metrics=true(default): Deletes the ticket while retaining reporting data. The ticket will still appear in reporting, though some data may be incomplete due to the deletion.With
retain_metrics=false: Deletes the ticket and all associated reporting data. The ticket will be completely removed from both the inbox and all reporting.
Using retain_metrics=false requires the delete_conversations_and_metrics OAuth scope.
Requires the write_conversations OAuth scope. If the ID refers to a ticket, the access token must also include the write_tickets scope. Without it, the request returns a 401 with the error code token_unauthorized.
Intercom API version.
If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.
- The production API serverhttps://api.intercom.io/tickets/{id}
- The european API serverhttps://api.eu.intercom.io/tickets/{id}
- The australian API serverhttps://api.au.intercom.io/tickets/{id}
curl -i -X DELETE \
'https://api.intercom.io/tickets/{id}?retain_metrics=true' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Intercom-Version: Preview'{ "id": "632", "object": "ticket", "deleted": true }