Skip to content

update delete tickets endpoint doc #371

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcmlc merged 1 commit into from
Feb 17, 2026
Merged

update delete tickets endpoint doc #371

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 41 additions & 51 deletions descriptions/0/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14330,7 +14330,12 @@ paths:
tags:
- Tickets
operationId: deleteTicket
description: You can delete a ticket using the Intercom provided ID.
description: |
{% 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.
responses:
'200':
description: successful
Expand All @@ -14343,24 +14348,7 @@ paths:
object: ticket
deleted: true
schema:
title: Ticket Deleted
type: object
description: Response when a ticket is deleted.
properties:
id:
type: string
description: The unique identifier for the ticket.
example: '42'
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
"$ref": "#/components/schemas/ticket_deleted"
'404':
description: Ticket not found
content:
Expand All @@ -14374,38 +14362,7 @@ paths:
- code: ticket_not_found
message: Ticket not found
schema:
type: object
title: Ticket not found error
properties:
type:
type: string
description: The type is error.list
example: error.list
request_id:
type: string
nullable: true
format: uuid
description: ''
example: f93ecfa8-d08a-4325-8694-89aeb89c8f85
errors:
type: array
description: An array of one or more error objects
items:
properties:
code:
type: string
description: ticket_not_found
example: ticket_not_found
message:
type: string
nullable: true
description: Ticket not found
example: Ticket not found
required:
- code
required:
- type
- errors
"$ref": "#/components/schemas/error"
'401':
description: Unauthorized
content:
Expand All @@ -14420,6 +14377,20 @@ paths:
message: Access Token Invalid
schema:
"$ref": "#/components/schemas/error"
'403':
description: API plan restricted
content:
application/json:
examples:
API plan restricted:
value:
type: error.list
request_id: 7a80b950-b392-499f-85db-ea7c6c424d37
errors:
- code: api_plan_restricted
message: Active subscription needed.
schema:
"$ref": "#/components/schemas/error"
"/tickets/search":
post:
summary: Search tickets
Expand Down Expand Up @@ -22707,6 +22678,25 @@ components:
type: boolean
description: Whether or not the ticket is shared with the customer.
example: true
ticket_deleted:
title: Ticket Deleted
type: object
description: deleted ticket object
properties:
id:
type: string
description: The unique identifier for the ticket.
example: 5ba682d23d7cf92bef87bfd4
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
ticket_contacts:
title: Contacts
type: object
Expand Down
92 changes: 41 additions & 51 deletions descriptions/2.13/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12326,7 +12326,12 @@ paths:
tags:
- Tickets
operationId: deleteTicket
description: You can delete a ticket using the Intercom provided ID.
description: |
{% 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.
responses:
'200':
description: successful
Expand All @@ -12339,24 +12344,7 @@ paths:
object: ticket
deleted: true
schema:
title: Ticket Deleted
type: object
description: Response when a ticket is deleted.
properties:
id:
type: string
description: The unique identifier for the ticket.
example: '42'
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
"$ref": "#/components/schemas/ticket_deleted"
'404':
description: Ticket not found
content:
Expand All @@ -12370,38 +12358,7 @@ paths:
- code: ticket_not_found
message: Ticket not found
schema:
type: object
title: Ticket not found error
properties:
type:
type: string
description: The type is error.list
example: error.list
request_id:
type: string
nullable: true
format: uuid
description: ''
example: f93ecfa8-d08a-4325-8694-89aeb89c8f85
errors:
type: array
description: An array of one or more error objects
items:
properties:
code:
type: string
description: ticket_not_found
example: ticket_not_found
message:
type: string
nullable: true
description: Ticket not found
example: Ticket not found
required:
- code
required:
- type
- errors
"$ref": "#/components/schemas/error"
'401':
description: Unauthorized
content:
Expand All @@ -12416,6 +12373,20 @@ paths:
message: Access Token Invalid
schema:
"$ref": "#/components/schemas/error"
'403':
description: API plan restricted
content:
application/json:
examples:
API plan restricted:
value:
type: error.list
request_id: 7a80b950-b392-499f-85db-ea7c6c424d37
errors:
- code: api_plan_restricted
message: Active subscription needed.
schema:
"$ref": "#/components/schemas/error"
"/tickets/search":
post:
summary: Search tickets
Expand Down Expand Up @@ -19095,6 +19066,25 @@ components:
type: boolean
description: Whether or not the ticket is shared with the customer.
example: true
ticket_deleted:
title: Ticket Deleted
type: object
description: deleted ticket object
properties:
id:
type: string
description: The unique identifier for the ticket.
example: 5ba682d23d7cf92bef87bfd4
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
ticket_contacts:
title: Contacts
type: object
Expand Down
92 changes: 41 additions & 51 deletions descriptions/2.14/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13495,7 +13495,12 @@ paths:
tags:
- Tickets
operationId: deleteTicket
description: You can delete a ticket using the Intercom provided ID.
description: |
{% 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.
responses:
'200':
description: successful
Expand All @@ -13508,24 +13513,7 @@ paths:
object: ticket
deleted: true
schema:
title: Ticket Deleted
type: object
description: Response when a ticket is deleted.
properties:
id:
type: string
description: The unique identifier for the ticket.
example: '42'
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
"$ref": "#/components/schemas/ticket_deleted"
'404':
description: Ticket not found
content:
Expand All @@ -13539,38 +13527,7 @@ paths:
- code: ticket_not_found
message: Ticket not found
schema:
type: object
title: Ticket not found error
properties:
type:
type: string
description: The type is error.list
example: error.list
request_id:
type: string
nullable: true
format: uuid
description: ''
example: f93ecfa8-d08a-4325-8694-89aeb89c8f85
errors:
type: array
description: An array of one or more error objects
items:
properties:
code:
type: string
description: ticket_not_found
example: ticket_not_found
message:
type: string
nullable: true
description: Ticket not found
example: Ticket not found
required:
- code
required:
- type
- errors
"$ref": "#/components/schemas/error"
'401':
description: Unauthorized
content:
Expand All @@ -13585,6 +13542,20 @@ paths:
message: Access Token Invalid
schema:
"$ref": "#/components/schemas/error"
'403':
description: API plan restricted
content:
application/json:
examples:
API plan restricted:
value:
type: error.list
request_id: 7a80b950-b392-499f-85db-ea7c6c424d37
errors:
- code: api_plan_restricted
message: Active subscription needed.
schema:
"$ref": "#/components/schemas/error"
"/tickets/search":
post:
summary: Search tickets
Expand Down Expand Up @@ -21025,6 +20996,25 @@ components:
type: boolean
description: Whether or not the ticket is shared with the customer.
example: true
ticket_deleted:
title: Ticket Deleted
type: object
description: deleted ticket object
properties:
id:
type: string
description: The unique identifier for the ticket.
example: 5ba682d23d7cf92bef87bfd4
object:
type: string
description: always ticket
enum:
- ticket
example: ticket
deleted:
type: boolean
description: Whether the ticket is deleted or not.
example: true
ticket_contacts:
title: Contacts
type: object
Expand Down
Loading