From 0adfee85e19adae48b4dea5fe98adfff041369b6 Mon Sep 17 00:00:00 2001 From: yasser-aboelgheit-intercom Date: Wed, 21 Oct 2026 11:30:55 +0100 Subject: [PATCH] Align the Preview update-team-members contract with the API Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/0/api.intercom.io.yaml | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index c8e4f160..48fe58b9 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -24448,7 +24448,7 @@ paths: - name: Intercom-Version in: header schema: - "$ref": "#/components/schemas/intercom_version" + "$ref": "#/components/schemas/intercom_version_preview" - name: id in: path required: true @@ -24470,6 +24470,7 @@ paths: they must be able to manage teams, and any team or teammate their access is restricted from remains out of reach here. requestBody: + required: true content: application/json: examples: @@ -30194,7 +30195,6 @@ components: admin_priority_level_request: title: Admin Priority Level Request type: object - nullable: true description: The priority levels to set, naming only the teammates whose level is being set properties: @@ -46280,7 +46280,9 @@ components: query string is rejected rather than applied. A team read from the API can be sent back whole, since the other fields of the representation are accepted as long as they are unchanged. Trying to change one of them returns a 400 rather than being - ignored, as does any field a team does not have. + ignored, as does any field a team does not have. `admin_ids` cannot be empty, so + the endpoint will not empty a team, and a team with no members cannot be sent back + as it reads. `admin_priority_level` sets which teammates take work first. It is optional, and names only the teammates whose level the request is setting: a teammate it leaves @@ -46295,7 +46297,7 @@ components: level rather than being refused. Only a team whose `distribution_method` is `load_balanced` can have secondary - members, so `secondary_admin_ids` returns a 400 on any other team. + members, so making a teammate secondary returns a 400 on any other team. `primary_admin_ids` is accepted on every team, but a team that does not balance assignment does not report `admin_priority_level` back and does not use the levels to decide who work goes to. @@ -46306,6 +46308,8 @@ components: type: array description: The ids of every teammate who should be a member of the team. Must contain at least one id, and no more than 1000. + minItems: 1 + maxItems: 1000 items: type: integer example: