From f82a9a532016598b20a3d950d8bf8ceca4b53944 Mon Sep 17 00:00:00 2001
From: Thibault Candebat <thibault@intercom.io>
Date: Mon, 16 Feb 2026 17:33:14 +0000
Subject: [PATCH] docs: Add role property to admin and admin_with_app schemas

Add role object (type, id, name) to the admin API response schemas
in the Unstable OpenAPI spec. Corresponds to intercom/intercom#470909.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 38 +++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index b401874..49d59c0 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -15633,6 +15633,25 @@ components:
           example: https://picsum.photos/200/300
         team_priority_level:
           "$ref": "#/components/schemas/team_priority_level"
+        role:
+          type: object
+          nullable: true
+          description: The role assigned to this admin. Only present if the admin has
+            a role assigned.
+          properties:
+            type:
+              type: string
+              description: String representing the object's type. Always has the value
+                `role`.
+              example: role
+            id:
+              type: string
+              description: The id of the role.
+              example: '1'
+            name:
+              type: string
+              description: The name of the role.
+              example: Support Agent
     admin_list:
       title: Admins
       type: object
@@ -15861,6 +15880,25 @@ components:
           description: Identifies if this admin's email is verified.
           nullable: true
           example: true
+        role:
+          type: object
+          nullable: true
+          description: The role assigned to this admin. Only present if the admin has
+            a role assigned.
+          properties:
+            type:
+              type: string
+              description: String representing the object's type. Always has the value
+                `role`.
+              example: role
+            id:
+              type: string
+              description: The id of the role.
+              example: '1'
+            name:
+              type: string
+              description: The name of the role.
+              example: Support Agent
         app:
           "$ref": "#/components/schemas/app"
           nullable: true