From 10b09d1e868b9b3ff9425195c2e5bbe4b7b29e23 Mon Sep 17 00:00:00 2001 From: adisa narula Date: Wed, 15 Apr 2026 16:56:12 +0100 Subject: [PATCH] Add display_avatar query parameter to GET /admins endpoint Document the display_avatar boolean query parameter on the list admins endpoint across all API versions (2.7-2.15 and Unstable). When set to true, the response includes the admin's avatar object with the image URL. Co-Authored-By: Claude Opus 4.6 --- descriptions/0/api.intercom.io.yaml | 8 ++++++++ descriptions/2.10/api.intercom.io.yaml | 8 ++++++++ descriptions/2.11/api.intercom.io.yaml | 8 ++++++++ descriptions/2.12/api.intercom.io.yaml | 8 ++++++++ descriptions/2.13/api.intercom.io.yaml | 8 ++++++++ descriptions/2.14/api.intercom.io.yaml | 8 ++++++++ descriptions/2.15/api.intercom.io.yaml | 8 ++++++++ descriptions/2.7/api.intercom.io.yaml | 8 ++++++++ descriptions/2.8/api.intercom.io.yaml | 8 ++++++++ descriptions/2.9/api.intercom.io.yaml | 8 ++++++++ 10 files changed, 80 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 150948c..52e7d9a 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -501,6 +501,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index b180793..cd15438 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index ea31455..55c32a1 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index fa34686..9cbb4b2 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 230d8f4..4098149 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 829c0f2..4fcceea 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -280,6 +280,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index 8581d7a..b49a8ec 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -280,6 +280,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index eb6b412..de7c263 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index cd29bdc..1ece758 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index 9662535..64a41f2 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -255,6 +255,14 @@ paths: in: header schema: "$ref": "#/components/schemas/intercom_version" + - name: display_avatar + in: query + required: false + description: If set to true, the response will include the admin's avatar + object containing the image URL. Defaults to false. + example: true + schema: + type: boolean tags: - Admins operationId: listAdmins