From 76aa56694836be6096b5c4b036ccc76700248e3d Mon Sep 17 00:00:00 2001 From: Laszlo Bogacsi Date: Mon, 7 Sep 2026 15:43:28 +0100 Subject: [PATCH 1/2] Correct the granted-companies limit to 100 The spec published the limit as 1,000, taken from an earlier draft. The implemented cap is 100 companies per contact. Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 9e01650a..4da530b7 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -7178,7 +7178,7 @@ paths: This is a replacement, not an append. The `company_ids` you send become the contact's entire granted set — any company id you leave out is dropped. To add a company, send the existing ids plus the new one; to remove one, send the existing ids minus that one; to drop every grant, send an empty array. - Identify companies by the `company_id` you set on them, the same values [`GET /contacts/{contact_id}/granted_companies`](/docs/references/preview/rest-api/api.intercom.io/contacts/listgrantedcompaniesforacontact) returns. Duplicates in the request are collapsed. A contact can be granted at most 1,000 companies. + Identify companies by the `company_id` you set on them, the same values [`GET /contacts/{contact_id}/granted_companies`](/docs/references/preview/rest-api/api.intercom.io/contacts/listgrantedcompaniesforacontact) returns. Duplicates in the request are collapsed. A contact can be granted at most 100 companies. The response echoes the stored set, so a `200` is confirmation of exactly what the contact can now read. @@ -7260,7 +7260,7 @@ paths: request_id: 4c1d0a5f-2b8e-4f7a-9c31-6d2e8a4b5f10 errors: - code: granted_company_limit_exceeded - message: A contact can be granted at most 1000 companies + message: A contact can be granted at most 100 companies schema: "$ref": "#/components/schemas/error" '404': From bd212cd2054d371b14e5c0397bb82244b205ab3a Mon Sep 17 00:00:00 2001 From: Laszlo Bogacsi Date: Mon, 7 Sep 2026 15:51:45 +0100 Subject: [PATCH 2/2] Correct the granted-companies request schema maximum to 100 The array constraint on the replace request still said 1000, so a generated client would have kept accepting oversized requests. Co-Authored-By: Claude Opus 5 (1M context) --- descriptions/0/api.intercom.io.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 4da530b7..27ded7c4 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -38410,8 +38410,8 @@ components: company_ids: type: array description: The `company_id` values of the companies to grant the contact - access to. Send an empty array to drop every grant. Maximum of 1,000 ids. - maxItems: 1000 + access to. Send an empty array to drop every grant. Maximum of 100 ids. + maxItems: 100 items: type: string example: acme-corp