|
1 | 1 | { |
2 | 2 | "openapi": "3.0.3", |
3 | 3 | "info": { |
4 | | - "version": "1.0.0-rc.3", |
| 4 | + "version": "1.0.0-rc.4", |
5 | 5 | "title": "GitHub v3 REST API", |
6 | 6 | "description": "GitHub's v3 REST API.", |
7 | 7 | "license": { |
|
17322 | 17322 | "/repos/{owner}/{repo}/actions/workflows/{workflow_id}": { |
17323 | 17323 | "get": { |
17324 | 17324 | "summary": "Get a workflow", |
17325 | | - "description": "Gets a specific workflow. You can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yaml`. 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.", |
| 17325 | + "description": "Gets a specific workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. 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.", |
17326 | 17326 | "tags": [ |
17327 | 17327 | "actions" |
17328 | 17328 | ], |
@@ -17370,10 +17370,49 @@ |
17370 | 17370 | } |
17371 | 17371 | } |
17372 | 17372 | }, |
| 17373 | + "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable": { |
| 17374 | + "put": { |
| 17375 | + "summary": "Disable a workflow", |
| 17376 | + "description": "Disables a workflow and sets the `state` of the workflow to `disabled_manually`. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint.", |
| 17377 | + "tags": [ |
| 17378 | + "actions" |
| 17379 | + ], |
| 17380 | + "operationId": "actions/disable-workflow", |
| 17381 | + "externalDocs": { |
| 17382 | + "description": "API method documentation", |
| 17383 | + "url": "https://developer.github.com/v3/actions/workflows/#disable-a-workflow" |
| 17384 | + }, |
| 17385 | + "parameters": [ |
| 17386 | + { |
| 17387 | + "$ref": "#/components/parameters/owner" |
| 17388 | + }, |
| 17389 | + { |
| 17390 | + "$ref": "#/components/parameters/repo" |
| 17391 | + }, |
| 17392 | + { |
| 17393 | + "$ref": "#/components/parameters/workflow-id" |
| 17394 | + } |
| 17395 | + ], |
| 17396 | + "responses": { |
| 17397 | + "204": { |
| 17398 | + "description": "Empty response" |
| 17399 | + } |
| 17400 | + }, |
| 17401 | + "x-github": { |
| 17402 | + "githubCloudOnly": false, |
| 17403 | + "enabledForGitHubApps": true, |
| 17404 | + "previews": [ |
| 17405 | + |
| 17406 | + ], |
| 17407 | + "category": "actions", |
| 17408 | + "subcategory": "workflows" |
| 17409 | + } |
| 17410 | + } |
| 17411 | + }, |
17373 | 17412 | "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches": { |
17374 | 17413 | "post": { |
17375 | 17414 | "summary": "Create a workflow dispatch event", |
17376 | | - "description": "You can use this endpoint to manually trigger a GitHub Actions workflow run. You can also replace `{workflow_id}` with the workflow file name. For example, you could use `main.yaml`.\n\nYou must configure your GitHub Actions workflow to run when the [`workflow_dispatch` webhook](/developers/webhooks-and-events/webhook-events-and-payloads#workflow_dispatch) event occurs. The `inputs` are configured in the workflow file. For more information about how to configure the `workflow_dispatch` event in the workflow file, see \"[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_dispatch).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint. For more information, see \"[Creating a personal access token for the command line](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line).\"", |
| 17415 | + "description": "You can use this endpoint to manually trigger a GitHub Actions workflow run. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`.\n\nYou must configure your GitHub Actions workflow to run when the [`workflow_dispatch` webhook](/developers/webhooks-and-events/webhook-events-and-payloads#workflow_dispatch) event occurs. The `inputs` are configured in the workflow file. For more information about how to configure the `workflow_dispatch` event in the workflow file, see \"[Events that trigger workflows](/actions/reference/events-that-trigger-workflows#workflow_dispatch).\"\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint. For more information, see \"[Creating a personal access token for the command line](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line).\"", |
17377 | 17416 | "operationId": "actions/create-workflow-dispatch", |
17378 | 17417 | "tags": [ |
17379 | 17418 | "actions" |
@@ -17442,10 +17481,49 @@ |
17442 | 17481 | } |
17443 | 17482 | } |
17444 | 17483 | }, |
| 17484 | + "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable": { |
| 17485 | + "put": { |
| 17486 | + "summary": "Enable a workflow", |
| 17487 | + "description": "Enables a workflow and sets the `state` of the workflow to `active`. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`.\n\nYou must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint.", |
| 17488 | + "tags": [ |
| 17489 | + "actions" |
| 17490 | + ], |
| 17491 | + "operationId": "actions/enable-workflow", |
| 17492 | + "externalDocs": { |
| 17493 | + "description": "API method documentation", |
| 17494 | + "url": "https://developer.github.com/v3/actions/workflows/#enable-a-workflow" |
| 17495 | + }, |
| 17496 | + "parameters": [ |
| 17497 | + { |
| 17498 | + "$ref": "#/components/parameters/owner" |
| 17499 | + }, |
| 17500 | + { |
| 17501 | + "$ref": "#/components/parameters/repo" |
| 17502 | + }, |
| 17503 | + { |
| 17504 | + "$ref": "#/components/parameters/workflow-id" |
| 17505 | + } |
| 17506 | + ], |
| 17507 | + "responses": { |
| 17508 | + "204": { |
| 17509 | + "description": "Empty response" |
| 17510 | + } |
| 17511 | + }, |
| 17512 | + "x-github": { |
| 17513 | + "githubCloudOnly": false, |
| 17514 | + "enabledForGitHubApps": true, |
| 17515 | + "previews": [ |
| 17516 | + |
| 17517 | + ], |
| 17518 | + "category": "actions", |
| 17519 | + "subcategory": "workflows" |
| 17520 | + } |
| 17521 | + } |
| 17522 | + }, |
17445 | 17523 | "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": { |
17446 | 17524 | "get": { |
17447 | 17525 | "summary": "List workflow runs", |
17448 | | - "description": "List all workflow runs for a workflow. You can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://developer.github.com/v3/#parameters).\n\nAnyone 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.", |
| 17526 | + "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://developer.github.com/v3/#parameters).\n\nAnyone 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.", |
17449 | 17527 | "tags": [ |
17450 | 17528 | "actions" |
17451 | 17529 | ], |
|
17530 | 17608 | "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/timing": { |
17531 | 17609 | "get": { |
17532 | 17610 | "summary": "Get workflow usage", |
17533 | | - "description": "**Warning:** This GitHub Actions usage endpoint is currently in public beta and subject to change. For more information, see \"[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage).\"\n\nGets the number of billable minutes used by a specific workflow during the current billing cycle. Billable minutes only apply to workflows in private repositories that use GitHub-hosted runners. Usage is listed for each GitHub-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nYou can also replace `:workflow_id` with `:workflow_file_name`. For example, you could use `main.yaml`. 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.", |
| 17611 | + "description": "**Warning:** This GitHub Actions usage endpoint is currently in public beta and subject to change. For more information, see \"[GitHub Actions API workflow usage](https://developer.github.com/changes/2020-05-15-actions-api-workflow-usage).\"\n\nGets the number of billable minutes used by a specific workflow during the current billing cycle. Billable minutes only apply to workflows in private repositories that use GitHub-hosted runners. Usage is listed for each GitHub-hosted runner operating system in milliseconds. Any job re-runs are also included in the usage. The usage does not include the multiplier for macOS and Windows runners and is not rounded up to the nearest whole minute. For more information, see \"[Managing billing for GitHub Actions](https://help.github.com/github/setting-up-and-managing-billing-and-payments-on-github/managing-billing-for-github-actions)\".\n\nYou can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. 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.", |
17534 | 17612 | "tags": [ |
17535 | 17613 | "actions" |
17536 | 17614 | ], |
|
0 commit comments