From 872e4b93b33d143e1021fe36259c4f5dabfa681e Mon Sep 17 00:00:00 2001 From: dq Date: Thu, 27 Aug 2026 14:32:05 +0100 Subject: [PATCH 1/2] Describe part assigned_to as the reference it actually returns assigned_to was documented as the id of the admin a part assigned. It is a reference object whose type can be admin, team or bot, and an unassignment returns nobody_admin with a null id, so team assignment looked absent from the API and the unassignment value was documented nowhere. Every published version returns the same shape for this field, so the wording is corrected on all of them rather than the Preview version alone. Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.10/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.11/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.12/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.13/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.14/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.15/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.16/api.intercom.io.yaml | 12 ++++++++---- descriptions/2.7/api.intercom.io.yaml | 6 ++++-- descriptions/2.8/api.intercom.io.yaml | 6 ++++-- descriptions/2.9/api.intercom.io.yaml | 12 ++++++++---- 11 files changed, 80 insertions(+), 40 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 1e420765..5bd2f18f 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -32323,8 +32323,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. admin_assignee_id: type: integer nullable: true @@ -40035,8 +40037,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. admin_assignee_id: type: integer nullable: true diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 18b6940d..b30fdd65 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -13299,8 +13299,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -16445,8 +16447,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 60f2a9fc..391ecf78 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -14074,8 +14074,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -18226,8 +18228,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 1ce744bf..de413f6a 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -14363,8 +14363,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -17833,8 +17835,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index e40c829d..d38a8be7 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -15801,8 +15801,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -19516,8 +19518,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index dba90d0e..c6b0f780 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -17529,8 +17529,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -22177,8 +22179,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 299f81ac..9819c1ec 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -18329,8 +18329,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -23186,8 +23188,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 32fad4b8..f01c8b44 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -27264,8 +27264,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -33973,8 +33975,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 1ff8de86..4174d116 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -11400,8 +11400,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index e95a6a55..a3246bc0 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -11424,8 +11424,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index 2fd8b1bc..1fcc0a19 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -12604,8 +12604,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this conversation_part assigned the conversation to, as + a reference whose `type` is `admin`, `team` or `bot`. When the part unassigned + the conversation, `type` is `nobody_admin` and `id` is `null`. Null when the + part did not change the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/conversation_part_author" attachments: @@ -15826,8 +15828,10 @@ components: assigned_to: "$ref": "#/components/schemas/reference" 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.) + description: The assignee this ticket_part assigned the ticket to, as a reference + whose `type` is `admin`, `team` or `bot`. When the part unassigned the ticket, + `type` is `nobody_admin` and `id` is `null`. Null when the part did not change + the assignment, or when the assignee has since been deleted. author: "$ref": "#/components/schemas/ticket_part_author" attachments: From f6d58d6a95e4d990ee362059e1be93abee14a911 Mon Sep 17 00:00:00 2001 From: dq Date: Thu, 27 Aug 2026 14:39:31 +0100 Subject: [PATCH 2/2] Drop the contact assignee from the comment part examples These examples showed assigned_to as a contact reference on a comment part. Assignment never produces a contact, and a comment changes no assignment, so the field is null there, as the other non-assignment examples already show. Left as an explicit null rather than invented ids, so the examples no longer contradict the field description. Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 4 ---- descriptions/2.13/api.intercom.io.yaml | 2 -- descriptions/2.14/api.intercom.io.yaml | 2 -- descriptions/2.15/api.intercom.io.yaml | 2 -- descriptions/2.16/api.intercom.io.yaml | 2 -- 5 files changed, 12 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 5bd2f18f..3ad3e2e5 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -12331,8 +12331,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274' @@ -12540,8 +12538,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274' diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index d38a8be7..80876bda 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -5901,8 +5901,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274' diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index c6b0f780..335a7bcf 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -6870,8 +6870,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274' diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 9819c1ec..472ac6d6 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -6793,8 +6793,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274' diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index f01c8b44..67648cee 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -11073,8 +11073,6 @@ paths: updated_at: 1663597260 notified_at: 1663597260 assigned_to: - type: contact - id: '1a2b3c' author: type: admin id: '274'