Skip to content

Document that ticket comments are not supported on internal ticket types #671

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
dan0505 merged 2 commits into from
Sep 21, 2026
Merged

Document that ticket comments are not supported on internal ticket types #671

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
a0dc25c
Document that ticket comments are not supported on internal ticket types
dan0505 Sep 18, 2026
7b6d505
Document the 400 returned when a ticket reply is rejected
dan0505 Sep 21, 2026
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
20 changes: 19 additions & 1 deletion descriptions/0/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23512,7 +23512,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -23523,6 +23523,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -28207,6 +28222,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
32 changes: 32 additions & 0 deletions descriptions/2.10/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9445,6 +9445,35 @@ paths:
tags:
- Tickets
responses:
'400':
description: Bad Request
content:
application/json:
examples:
User reply:
value:
type: error.list
request_id: b8b42c55-347c-4704-b4c1-92220c01f4ac
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
description: Admin quick_reply reply
content:
Expand Down Expand Up @@ -11248,6 +11277,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.11/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9534,7 +9534,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -9545,6 +9545,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -11364,6 +11379,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.12/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10247,7 +10247,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -10258,6 +10258,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -12089,6 +12104,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.13/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11475,7 +11475,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -11486,6 +11486,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -13459,6 +13474,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.14/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12883,7 +12883,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -12894,6 +12894,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -15076,6 +15091,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.15/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12866,7 +12866,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -12877,6 +12877,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -15709,6 +15724,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
20 changes: 19 additions & 1 deletion descriptions/2.16/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19506,7 +19506,7 @@ paths:
- Tickets
responses:
'400':
description: User reply
description: Bad Request
content:
application/json:
examples:
Expand All @@ -19517,6 +19517,21 @@ paths:
errors:
- code: parameter_mismatch
message: User replies are not allowed on Backoffice tickets
Admin comment on a back-office ticket:
value:
type: error.list
request_id: 7a1c9f02-5d3e-4b8a-9c21-6f0d84e5b713
errors:
- code: parameter_mismatch
message: Comments are not allowed on Backoffice tickets not
shared with user
Admin comment on a tracker ticket:
value:
type: error.list
request_id: c4e2a980-31bf-4d76-8a05-2e9cb17f4d6a
errors:
- code: parameter_mismatch
message: Comments are not allowed on Tracker tickets
schema:
"$ref": "#/components/schemas/error"
'200':
Expand Down Expand Up @@ -22959,6 +22974,9 @@ components:
properties:
message_type:
type: string
description: The type of reply. Tracker tickets and back-office tickets
that are not shared with the customer do not support `comment`; use
`note` instead.
enum:
- comment
- note
Expand Down
Loading