Add applied_at and applied_by fields to tag endpoint examples (#360)

* Add applied_at and applied_by fields to tag endpoint examples

Update OpenAPI spec to reflect the VersionedTaggingPresenter changes:
- Change GET /contacts/{id}/tags schema from tag_list to tags
- Add applied_at and applied_by fields to all entity tag endpoint examples
  (contacts, conversations, tickets)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Use tag_basic schema for workspace-level tag endpoints

Workspace-level endpoints (GET /tags, POST /tags, GET /tags/{id}) and
embedded company tags use TagResponse, not VersionedTaggingPresenter,
so they don't include applied_at/applied_by fields.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Make applied_at and applied_by nullable in tag schema

DELETE tag endpoints are idempotent - they return 200 OK even when the
tag wasn't applied. In that case, applied_at and applied_by are null.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Revert GET /contacts/{id}/tags envelope to list/data format

The original Intercom PR was reverted and replaced with one that keeps
the existing { type: "list", data: [...] } envelope. Update the example
and schema reference (tags -> tag_list) to match, and use the full tag
schema for tag_list items so applied_at/applied_by are included.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: VedranZoricic

descriptions/0/api.intercom.io.yaml

@@ -4409,6 +4409,10 @@ paths:
                     - type: tag
                       id: '80'
                       name: Manual tag
+                      applied_at: 1663597223
+                      applied_by:
+                        type: admin
+                        id: '456'
               schema:
                 "$ref": "#/components/schemas/tag_list"
         '404':
@@ -4470,6 +4474,10 @@ paths:
                     type: tag
                     id: '81'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -4572,6 +4580,10 @@ paths:
                     type: tag
                     id: '84'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -5787,6 +5799,10 @@ paths:
                     type: tag
                     id: '86'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -5886,6 +5902,10 @@ paths:
                     type: tag
                     id: '89'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -12064,7 +12084,7 @@ paths:
                     id: '105'
                     name: test
               schema:
-                "$ref": "#/components/schemas/tag"
+                "$ref": "#/components/schemas/tag_basic"
         '400':
           description: Invalid parameters
           content:
@@ -12177,7 +12197,7 @@ paths:
                     id: '113'
                     name: Manual tag
               schema:
-                "$ref": "#/components/schemas/tag"
+                "$ref": "#/components/schemas/tag_basic"
         '404':
           description: Tag not found
           content:
@@ -13451,6 +13471,10 @@ paths:
                     type: tag
                     id: '121'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -13550,6 +13574,10 @@ paths:
                     type: tag
                     id: '124'
                     name: Manual tag
+                    applied_at: 1663597223
+                    applied_by:
+                      type: admin
+                      id: '456'
               schema:
                 "$ref": "#/components/schemas/tag"
         '404':
@@ -16895,8 +16923,7 @@ components:
             tags:
               type: array
               items:
-                items:
-                  "$ref": "#/components/schemas/tag"
+                "$ref": "#/components/schemas/tag_basic"
         segments:
           type: object
           description: The list of segments associated with the company
@@ -22397,10 +22424,15 @@ components:
         applied_at:
           type: integer
           format: date-time
+          nullable: true
           description: The time when the tag was applied to the object
           example: 1663597223
         applied_by:
-          "$ref": "#/components/schemas/reference"
+          type: object
+          nullable: true
+          description: The admin who applied the tag
+          allOf:
+            - "$ref": "#/components/schemas/reference"
     tag_basic:
       title: Tag
       type: object