Skip to content
Merged
Changes from all commits
Commits
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
8 changes: 4 additions & 4 deletions descriptions/0/api.intercom.io.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -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':
Expand Down Expand Up @@ -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
Expand Down