Merge pull request #619 from github/openapi-update-9dd50357ae91f678316b0a7946891bb7ae1d55593c5f5506f8d90fd011f40b39

Update OpenAPI Descriptions

Author: nickfloyd

descriptions/api.github.com/api.github.com.json

@@ -18797,6 +18797,89 @@
         }
       }
     },
+    "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs": {
+      "get": {
+        "summary": "List jobs for a workflow run attempt",
+        "description": "Lists jobs for a specific workflow run attempt. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).",
+        "tags": [
+          "actions"
+        ],
+        "operationId": "actions/list-jobs-for-workflow-run-attempt",
+        "externalDocs": {
+          "description": "API method documentation",
+          "url": "https://docs.github.com/rest/reference/actions#list-jobs-for-a-workflow-run-attempt"
+        },
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/owner"
+          },
+          {
+            "$ref": "#/components/parameters/repo"
+          },
+          {
+            "$ref": "#/components/parameters/run-id"
+          },
+          {
+            "$ref": "#/components/parameters/attempt-number"
+          },
+          {
+            "$ref": "#/components/parameters/per-page"
+          },
+          {
+            "$ref": "#/components/parameters/page"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "total_count",
+                    "jobs"
+                  ],
+                  "properties": {
+                    "total_count": {
+                      "type": "integer"
+                    },
+                    "jobs": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/job"
+                      }
+                    }
+                  }
+                },
+                "examples": {
+                  "default": {
+                    "$ref": "#/components/examples/job-paginated"
+                  }
+                }
+              }
+            },
+            "headers": {
+              "Link": {
+                "$ref": "#/components/headers/link"
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/not_found"
+          }
+        },
+        "x-github": {
+          "githubCloudOnly": false,
+          "enabledForGitHubApps": true,
+          "previews": [
+
+          ],
+          "category": "actions",
+          "subcategory": "workflow-jobs"
+        }
+      }
+    },
     "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs": {
       "get": {
         "summary": "Download workflow run attempt logs",
@@ -39416,6 +39499,9 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Response if you upload an asset with the same filename as another uploaded asset"
           }
         },
         "x-github": {

descriptions/api.github.com/api.github.com.yaml

@@ -13141,6 +13141,59 @@ paths:
         previews: []
         category: actions
         subcategory: workflow-runs
+  "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/jobs":
+    get:
+      summary: List jobs for a workflow run attempt
+      description: Lists jobs for a specific workflow run attempt. Anyone with read
+        access to the repository can use this endpoint. If the repository is private
+        you must use an access token with the `repo` scope. GitHub Apps must have
+        the `actions:read` permission to use this endpoint. You can use parameters
+        to narrow the list of results. For more information about using parameters,
+        see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).
+      tags:
+      - actions
+      operationId: actions/list-jobs-for-workflow-run-attempt
+      externalDocs:
+        description: API method documentation
+        url: https://docs.github.com/rest/reference/actions#list-jobs-for-a-workflow-run-attempt
+      parameters:
+      - "$ref": "#/components/parameters/owner"
+      - "$ref": "#/components/parameters/repo"
+      - "$ref": "#/components/parameters/run-id"
+      - "$ref": "#/components/parameters/attempt-number"
+      - "$ref": "#/components/parameters/per-page"
+      - "$ref": "#/components/parameters/page"
+      responses:
+        '200':
+          description: Response
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                - total_count
+                - jobs
+                properties:
+                  total_count:
+                    type: integer
+                  jobs:
+                    type: array
+                    items:
+                      "$ref": "#/components/schemas/job"
+              examples:
+                default:
+                  "$ref": "#/components/examples/job-paginated"
+          headers:
+            Link:
+              "$ref": "#/components/headers/link"
+        '404':
+          "$ref": "#/components/responses/not_found"
+      x-github:
+        githubCloudOnly: false
+        enabledForGitHubApps: true
+        previews: []
+        category: actions
+        subcategory: workflow-jobs
   "/repos/{owner}/{repo}/actions/runs/{run_id}/attempts/{attempt_number}/logs":
     get:
       summary: Download workflow run attempt logs
@@ -27751,6 +27804,9 @@ paths:
               examples:
                 response-for-successful-upload:
                   "$ref": "#/components/examples/release-asset-response-for-successful-upload"
+        '422':
+          description: Response if you upload an asset with the same filename as another
+            uploaded asset
       x-github:
         githubCloudOnly: false
         enabledForGitHubApps: true