docs: Add role property to admin and admin_with_app schemas (#370)

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>

Author: thibault-intercom

descriptions/0/api.intercom.io.yaml

@@ -15620,6 +15620,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
@@ -15848,6 +15867,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