Update OpenAPI spec

Author: unified-ci-app[bot]

site/static/mattermost-openapi-v4.yaml

@@ -21329,8 +21329,8 @@ paths:
                 value:
                   channel_id: 4xp9fdt77pncbef59f4k1qe83o
                   cursor: ""
-                  per_page: 100
                   start_time: 1635638400000
+                  per_page: 100
               descending_order:
                 summary: Descending order from recent
                 value:
@@ -21371,19 +21371,19 @@ paths:
                         message: First post
                         create_at: 1635638400000
                       post_id_2:
-                        message: Second post
                         create_at: 1635638500000
                         id: post_id_2
+                        message: Second post
                     next_cursor:
                       cursor: MTphYmMxMjM6Y3JlYXRlX2F0OmZhbHNlOmZhbHNlOmFzYzoxNjM1NjM4NTAwMDAwOnBvc3RfaWRfMg
                 last_page:
                   summary: Last page (no more results)
                   value:
                     posts:
                       post_id_99:
-                        id: post_id_99
                         message: Last post
                         create_at: 1635724800000
+                        id: post_id_99
         "400":
           $ref: '#/components/responses/BadRequest'
         "401":
@@ -23637,9 +23637,9 @@ paths:
                   type: string
                   description: The name of the playbook run.
                   example: Server down in EU cluster
-                description:
+                summary:
                   type: string
-                  description: The description of the playbook run.
+                  description: The summary of the playbook run.
                   example: There is one server in the EU cluster that is not responding since April 12.
                 owner_user_id:
                   type: string
@@ -23663,7 +23663,7 @@ paths:
             curl -X POST 'http://localhost:8065/plugins/playbooks/api/v0/runs' \
             -H 'Authorization: Bearer 9g64ig7q9pds8yjz8rsgd6e36e'\
             -H 'Content-Type: application/json'\
-            -d '{"name": "Server down in EU cluster", "description": "There is one server in the EU cluster that is not responding since April 12.", "owner_user_id": "bqnbdf8uc0a8yz4i39qrpgkvtg", "team_id": "61ji2mpflefup3cnuif80r5rde", "playbook_id": "0y4a0ntte97cxvfont8y84wa7x"}'
+            -d '{"name": "Server down in EU cluster", "summary": "There is one server in the EU cluster that is not responding since April 12.", "owner_user_id": "bqnbdf8uc0a8yz4i39qrpgkvtg", "team_id": "61ji2mpflefup3cnuif80r5rde", "playbook_id": "0y4a0ntte97cxvfont8y84wa7x"}'
       responses:
         "201":
           description: Created playbook run.
@@ -24028,15 +24028,22 @@ paths:
               properties:
                 name:
                   type: string
-                  description: The new name of the playbook run.
+                  description: The new name of the playbook run. Must not be empty.
                   example: Updated Server Down Incident
+                summary:
+                  type: string
+                  description: The new summary of the playbook run. Can be empty to clear the summary.
+                  example: |-
+                    ## Incident Summary
+
+                    Resolved the server outage.
       x-codeSamples:
         - lang: curl
           source: |
             curl -X PATCH 'http://localhost:8065/plugins/playbooks/api/v0/runs/mx3xyzdojfgyfdx8sc8of1gdme' \
             -H 'Authorization: Bearer 9g64ig7q9pds8yjz8rsgd6e36e'\
             -H 'Content-Type: application/json'\
-            -d '{"name": "Updated Server Down Incident"}'
+            -d '{"name": "Updated Server Down Incident", "summary": "## Summary\n\nResolved the server outage."}'
       responses:
         "200":
           description: Playbook run successfully updated.
@@ -24458,7 +24465,7 @@ paths:
   /plugins/playbooks/api/v0/runs/{id}/checklists/{checklist}/item/{item}:
     put:
       summary: Update an item of a playbook run's checklist
-      description: Update the title and the slash command of an item in one of the playbook run's checklists.
+      description: Update the title, slash command, and description of an item in one of the playbook run's checklists.
       operationId: itemRename
       security:
         - BearerAuth: []
@@ -24501,6 +24508,10 @@ paths:
                   type: string
                   description: The new slash command of the item.
                   example: /jira update ticket
+                description:
+                  type: string
+                  description: The new description of the item, formatted with Markdown.
+                  example: Ask the customer for more information in [Zendesk](https://www.zendesk.com/).
               required:
                 - title
                 - command
@@ -24509,7 +24520,7 @@ paths:
           source: |
             curl -X PUT 'http://localhost:8065/plugins/playbooks/api/v0/runs/6t7jdgyqr7b5sk24zkauhmrb06/checklists/1/item/0' \
             -H 'Authorization: Bearer 9g64ig7q9pds8yjz8rsgd6e36e'\
-            -d '{"title": "Gather information from server's logs.", "command": "/jira update ticket"}'
+            -d '{"title": "Gather information from server's logs.", "command": "/jira update ticket", "description": "Ask the customer for more information in [Zendesk](https://www.zendesk.com/)."}'
       responses:
         "200":
           description: Item updated.
@@ -26254,8 +26265,8 @@ components:
           description: Additional attributes for the property field (options for select fields, visibility, etc.).
           additionalProperties: true
           example:
-            sortOrder: 1
             visibility: when_set
+            sortOrder: 1
             options:
               - color: '#ff0000'
                 id: opt1
@@ -30511,9 +30522,9 @@ components:
           type: string
           description: The name of the playbook run.
           example: Server down in EU cluster
-        description:
+        summary:
           type: string
-          description: The description of the playbook run.
+          description: The summary of the playbook run.
           example: There is one server in the EU cluster that is not responding since April 12.
         is_active:
           type: boolean