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 150948cb..52e7d9af 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 b1807935..cd154385 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 ea31455a..55c32a15 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 fa346862..9cbb4b2f 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 230d8f4d..40981494 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 829c0f26..4fcceea2 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 8581d7a4..b49a8ecd 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 eb6b412f..de7c263e 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 cd29bdc7..1ece758a 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 96625357..64a41f24 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