From 524ca28bc663e4f56ea75fcb3526d9d7d4ec7b49 Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Fri, 17 Apr 2026 15:31:25 +0100 Subject: [PATCH 1/2] Change ticket assignee ID fields to integer type in Preview spec MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Convert admin_assignee_id and team_assignee_id from string to integer in the Preview API spec to align the Ticket API with the Conversation API, which already returns these fields as integers. Mirrors intercom/developer-docs#849 (backend: intercom/intercom#497865). Affected endpoints: POST /tickets, PUT /tickets/{id}, POST /tickets/search. Stable versions (2.7–2.15) are not affected. Co-Authored-By: Claude Opus 4.6 --- descriptions/0/api.intercom.io.yaml | 36 ++++++++++++++--------------- 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index ebbedce..258c8ed 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -10098,8 +10098,8 @@ paths: - type: contact id: 6762f2041bb69f9f2193bc0c external_id: '70' - admin_assignee_id: '0' - team_assignee_id: '0' + admin_assignee_id: 0 + team_assignee_id: 0 created_at: 1734537732 updated_at: 1734537737 ticket_parts: @@ -16426,8 +16426,8 @@ paths: - type: contact id: 6762f2d81bb69f9f2193bc54 external_id: '70' - admin_assignee_id: '0' - team_assignee_id: '0' + admin_assignee_id: 0 + team_assignee_id: 0 created_at: 1734537944 updated_at: 1734537946 ticket_parts: @@ -16668,8 +16668,8 @@ paths: - type: contact id: 6762f2dd1bb69f9f2193bc55 external_id: 8df1fa21-b41d-4621-9229-d6f7a3a590ce - admin_assignee_id: '991268013' - team_assignee_id: '0' + admin_assignee_id: 991268013 + team_assignee_id: 0 created_at: 1734537950 updated_at: 1734537955 ticket_parts: @@ -16974,8 +16974,8 @@ paths: - type: contact id: 6762f2f61bb69f9f2193bc59 external_id: b16afa36-2637-4880-adee-a46d145bc27f - admin_assignee_id: '0' - team_assignee_id: '0' + admin_assignee_id: 0 + team_assignee_id: 0 created_at: 1734537974 updated_at: 1734537976 ticket_parts: @@ -17159,8 +17159,8 @@ paths: - type: contact id: 667d61c88a68186f43bafe93 external_id: '71' - admin_assignee_id: '0' - team_assignee_id: '0' + admin_assignee_id: 0 + team_assignee_id: 0 created_at: 1719493065 updated_at: 1719493068 ticket_parts: @@ -17322,8 +17322,8 @@ paths: | ticket_type_id | String | | contact_ids | String | | teammate_ids | String | - | admin_assignee_id | String | - | team_assignee_id | String | + | admin_assignee_id | Integer | + | team_assignee_id | Integer | | open | Boolean | | state | String | | snoozed_until | Date (UNIX timestamp) | @@ -17439,8 +17439,8 @@ paths: - type: contact id: 6762f3061bb69f9f2193bc5b external_id: 9b913927-c084-4391-b1db-098341b5ffe3 - admin_assignee_id: '0' - team_assignee_id: '0' + admin_assignee_id: 0 + team_assignee_id: 0 created_at: 1734537990 updated_at: 1734537992 ticket_parts: @@ -27461,13 +27461,13 @@ components: contacts: "$ref": "#/components/schemas/ticket_contacts" admin_assignee_id: - type: string + type: integer description: The id representing the admin assigned to the ticket. - example: '1295' + example: 1295 team_assignee_id: - type: string + type: integer description: The id representing the team assigned to the ticket. - example: '1295' + example: 1295 created_at: type: integer format: date-time From 36392e130d58f3d19d21a210992548559b629274 Mon Sep 17 00:00:00 2001 From: Varshini Suresh Date: Wed, 22 Apr 2026 15:55:57 +0100 Subject: [PATCH 2/2] Update conversation assignee ID nullability and ticket descriptions in Preview spec Conversation schemas: remove nullable from admin_assignee_id and team_assignee_id, return 0 instead of null when unassigned. Ticket schema: add return-0-when-unassigned language to descriptions. Aligns with developer-docs PR #849. Co-Authored-By: Claude Opus 4.6 --- descriptions/0/api.intercom.io.yaml | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 258c8ed..2e60437 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -21241,15 +21241,13 @@ components: example: priority admin_assignee_id: type: integer - nullable: true description: The id of the admin assigned to the conversation. If it's not - assigned to an admin it will return null. + assigned to an admin it will return 0. example: 0 team_assignee_id: type: integer - nullable: true description: The id of the team assigned to the conversation. If it's not - assigned to a team it will return null. + assigned to a team it will return 0. example: 5017691 company: "$ref": "#/components/schemas/company" @@ -21362,15 +21360,13 @@ components: example: priority admin_assignee_id: type: integer - nullable: true description: The id of the admin assigned to the conversation. If it's not - assigned to an admin it will return null. + assigned to an admin it will return 0. example: 0 team_assignee_id: type: integer - nullable: true description: The id of the team assigned to the conversation. If it's not - assigned to a team it will return null. + assigned to a team it will return 0. example: 5017691 company: "$ref": "#/components/schemas/company" @@ -27462,11 +27458,11 @@ components: "$ref": "#/components/schemas/ticket_contacts" admin_assignee_id: type: integer - description: The id representing the admin assigned to the ticket. + description: The id representing the admin assigned to the ticket. If it's not assigned to an admin it will return 0. example: 1295 team_assignee_id: type: integer - description: The id representing the team assigned to the ticket. + description: The id representing the team assigned to the ticket. If it's not assigned to a team it will return 0. example: 1295 created_at: type: integer