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 1e42076..5bd2f18 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 18b6940..b30fdd6 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 60f2a9f..391ecf7 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 1ce744b..de413f6 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 e40c829..d38a8be 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 dba90d0..c6b0f78 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 299f81a..9819c1e 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 32fad4b..f01c8b4 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 1ff8de8..4174d11 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 e95a6a5..a3246bc 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 2fd8b1b..1fcc0a1 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 5bd2f18..3ad3e2e 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 d38a8be..80876bd 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 c6b0f78..335a7bc 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 9819c1e..472ac6d 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 f01c8b4..67648ce 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'