Skip to content

Add admin_assignee_id and team_assignee_id to conversation part and ticket part schemas #635

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 6 commits into from
Aug 27, 2026
Merged

Add admin_assignee_id and team_assignee_id to conversation part and ticket part schemas #635

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
189e48d
Add team_assigned_to to conversation part and ticket part schemas
dan0505 Aug 25, 2026
92daeee
Use unassigned rather than nobody_team for a removed team
dan0505 Aug 26, 2026
dda9d3a
Report part assignees as admin_assignee_id and team_assignee_id
dan0505 Aug 27, 2026
5082b02
Note that the part assignee id fields can be absent as well as null
dan0505 Aug 27, 2026
98dc6fc
Correct when the part assignee ids return 0
dan0505 Aug 27, 2026
d7a07aa
Add examples for the part assignee id fields
dan0505 Aug 27, 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
44 changes: 44 additions & 0 deletions descriptions/0/api.intercom.io.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14012,6 +14012,8 @@ paths:
assigned_to:
type: admin
id: '991267715'
admin_assignee_id: 991267715
team_assignee_id: 5017691
author:
id: '991267715'
type: admin
Expand Down Expand Up @@ -23483,6 +23485,8 @@ paths:
assigned_to:
type: admin
id: '991268013'
admin_assignee_id: 991268013
team_assignee_id: null
author:
id: '991268011'
type: admin
Expand Down Expand Up @@ -32085,6 +32089,26 @@ components:
nullable: true
description: The id of the admin that was assigned the conversation by this
conversation_part (null if there has been no change in assignment.)
admin_assignee_id:
type: integer
nullable: true
description: The id of the teammate that this conversation_part assigned the
conversation to, or 0 if the part removed the teammate. Null or absent when
the part did not change the teammate, including an unassignment that did not
name which assignee it cleared. A bot is reported here, because assignment
treats anything that is not a team as a teammate.
example: 991267715
team_assignee_id:
type: integer
nullable: true
description: The id of the team that this conversation_part assigned the
conversation to, or 0 if the part removed the team. Null or absent when the
part did not change the team, including an unassignment that did not name
which assignee it cleared. A part can assign a team and a teammate at the
same time, for example when the team uses Round Robin distribution and the
teammate is resolved inline. In that case assigned_to reports only the
teammate, and these two fields report each assignee separately.
example: 5017691
author:
"$ref": "#/components/schemas/conversation_part_author"
attachments:
Expand Down Expand Up @@ -39754,6 +39778,26 @@ components:
nullable: true
description: The id of the admin that was assigned the ticket by this ticket_part
(null if there has been no change in assignment.)
admin_assignee_id:
type: integer
nullable: true
description: The id of the teammate that this ticket_part assigned the ticket
to, or 0 if the part removed the teammate. Null or absent when the part did
not change the teammate, including an unassignment that did not name which
assignee it cleared. A bot is reported here, because assignment treats
anything that is not a team as a teammate.
example: 991268013
team_assignee_id:
type: integer
nullable: true
description: The id of the team that this ticket_part assigned the ticket to,
or 0 if the part removed the team. Null or absent when the part did not
change the team, including an unassignment that did not name which assignee
it cleared. A part can assign a team and a teammate at the same time, for
example when the team uses Round Robin distribution and the teammate is
resolved inline. In that case assigned_to reports only the teammate, and
these two fields report each assignee separately.
example: 5017691
author:
"$ref": "#/components/schemas/ticket_part_author"
attachments:
Expand Down