|
1 | 1 | { |
2 | 2 | "openapi": "3.0.3", |
3 | 3 | "info": { |
4 | | - "version": "7.12.0", |
| 4 | + "version": "7.13.0", |
5 | 5 | "title": "GitHub's official OpenAPI spec + Octokit extension", |
6 | 6 | "description": "OpenAPI specs from https://github.com/github/rest-api-description with the 'x-octokit' extension required by the Octokit SDKs", |
7 | 7 | "license": { |
|
8270 | 8270 | }, |
8271 | 8271 | { |
8272 | 8272 | "name": "state", |
8273 | | - "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.", |
| 8273 | + "description": "Indicates the state of the issues to return.", |
8274 | 8274 | "in": "query", |
8275 | 8275 | "required": false, |
8276 | 8276 | "schema": { |
|
8288 | 8288 | }, |
8289 | 8289 | { |
8290 | 8290 | "name": "sort", |
8291 | | - "description": "What to sort results by. Can be either `created`, `updated`, `comments`.", |
| 8291 | + "description": "What to sort results by.", |
8292 | 8292 | "in": "query", |
8293 | 8293 | "required": false, |
8294 | 8294 | "schema": { |
|
8547 | 8547 | "type": "string" |
8548 | 8548 | }, |
8549 | 8549 | "mode": { |
8550 | | - "description": "The rendering mode. Can be either `markdown` or `gfm`.", |
| 8550 | + "description": "The rendering mode.", |
8551 | 8551 | "enum": [ |
8552 | 8552 | "markdown", |
8553 | 8553 | "gfm" |
|
12408 | 12408 | }, |
12409 | 12409 | { |
12410 | 12410 | "name": "state", |
12411 | | - "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.", |
| 12411 | + "description": "Indicates the state of the issues to return.", |
12412 | 12412 | "in": "query", |
12413 | 12413 | "required": false, |
12414 | 12414 | "schema": { |
|
12426 | 12426 | }, |
12427 | 12427 | { |
12428 | 12428 | "name": "sort", |
12429 | | - "description": "What to sort results by. Can be either `created`, `updated`, `comments`.", |
| 12429 | + "description": "What to sort results by.", |
12430 | 12430 | "in": "query", |
12431 | 12431 | "required": false, |
12432 | 12432 | "schema": { |
|
13339 | 13339 | }, |
13340 | 13340 | { |
13341 | 13341 | "name": "state", |
13342 | | - "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.", |
| 13342 | + "description": "Indicates the state of the projects to return.", |
13343 | 13343 | "in": "query", |
13344 | 13344 | "required": false, |
13345 | 13345 | "schema": { |
|
27447 | 27447 | }, |
27448 | 27448 | "put": { |
27449 | 27449 | "summary": "Create or update file contents", |
27450 | | - "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.", |
| 27450 | + "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint. \n\n**Note:** If you use this endpoint and the \"[Delete a file](https://docs.github.com/[email protected]/rest/reference/repos/#delete-file)\" endpoint in parallel, the concurrent requests will conflict and you will receive errors. You must use these endpoints serially instead.", |
27451 | 27451 | "tags": [ |
27452 | 27452 | "repos" |
27453 | 27453 | ], |
|
27626 | 27626 | }, |
27627 | 27627 | "delete": { |
27628 | 27628 | "summary": "Delete a file", |
27629 | | - "description": "Deletes a file in a repository.\n\nYou can provide an additional `committer` parameter, which is an object containing information about the committer. Or, you can provide an `author` parameter, which is an object containing information about the author.\n\nThe `author` section is optional and is filled in with the `committer` information if omitted. If the `committer` information is omitted, the authenticated user's information is used.\n\nYou must provide values for both `name` and `email`, whether you choose to use `author` or `committer`. Otherwise, you'll receive a `422` status code.", |
| 27629 | + "description": "Deletes a file in a repository.\n\nYou can provide an additional `committer` parameter, which is an object containing information about the committer. Or, you can provide an `author` parameter, which is an object containing information about the author.\n\nThe `author` section is optional and is filled in with the `committer` information if omitted. If the `committer` information is omitted, the authenticated user's information is used.\n\nYou must provide values for both `name` and `email`, whether you choose to use `author` or `committer`. Otherwise, you'll receive a `422` status code. \n\n**Note:** If you use this endpoint and the \"[Create or update file contents](https://docs.github.com/[email protected]/rest/reference/repos/#create-or-update-file-contents)\" endpoint in parallel, the concurrent requests will conflict and you will receive errors. You must use these endpoints serially instead.", |
27630 | 27630 | "tags": [ |
27631 | 27631 | "repos" |
27632 | 27632 | ], |
|
29243 | 29243 | }, |
29244 | 29244 | { |
29245 | 29245 | "name": "sort", |
29246 | | - "description": "The sort order. Can be either `newest`, `oldest`, or `stargazers`.", |
| 29246 | + "description": "The sort order. `stargazers` will sort by star count.", |
29247 | 29247 | "in": "query", |
29248 | 29248 | "required": false, |
29249 | 29249 | "schema": { |
|
31576 | 31576 | }, |
31577 | 31577 | { |
31578 | 31578 | "name": "state", |
31579 | | - "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.", |
| 31579 | + "description": "Indicates the state of the issues to return.", |
31580 | 31580 | "in": "query", |
31581 | 31581 | "required": false, |
31582 | 31582 | "schema": { |
|
31621 | 31621 | }, |
31622 | 31622 | { |
31623 | 31623 | "name": "sort", |
31624 | | - "description": "What to sort results by. Can be either `created`, `updated`, `comments`.", |
| 31624 | + "description": "What to sort results by.", |
31625 | 31625 | "in": "query", |
31626 | 31626 | "required": false, |
31627 | 31627 | "schema": { |
|
36268 | 36268 | }, |
36269 | 36269 | { |
36270 | 36270 | "name": "state", |
36271 | | - "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.", |
| 36271 | + "description": "Indicates the state of the projects to return.", |
36272 | 36272 | "in": "query", |
36273 | 36273 | "required": false, |
36274 | 36274 | "schema": { |
|
36493 | 36493 | }, |
36494 | 36494 | { |
36495 | 36495 | "name": "sort", |
36496 | | - "description": "What to sort results by. Can be either `created`, `updated`, `popularity` (comment count) or `long-running` (age, filtering by pulls updated in the last month).", |
| 36496 | + "description": "What to sort results by. `popularity` will sort by the number of comments. `long-running` will sort by date created and will limit the results to pull requests that have been open for more than a month and have had activity within the past month.", |
36497 | 36497 | "in": "query", |
36498 | 36498 | "required": false, |
36499 | 36499 | "schema": { |
|
36509 | 36509 | }, |
36510 | 36510 | { |
36511 | 36511 | "name": "direction", |
36512 | | - "description": "The direction of the sort. Can be either `asc` or `desc`. Default: `desc` when sort is `created` or sort is not specified, otherwise `asc`.", |
| 36512 | + "description": "The direction of the sort. Default: `desc` when sort is `created` or sort is not specified, otherwise `asc`.", |
36513 | 36513 | "in": "query", |
36514 | 36514 | "required": false, |
36515 | 36515 | "schema": { |
|
36721 | 36721 | }, |
36722 | 36722 | { |
36723 | 36723 | "name": "direction", |
36724 | | - "description": "Can be either `asc` or `desc`. Ignored without `sort` parameter.", |
| 36724 | + "description": "The direction to sort results. Ignored without `sort` parameter.", |
36725 | 36725 | "in": "query", |
36726 | 36726 | "required": false, |
36727 | 36727 | "schema": { |
|
37401 | 37401 | }, |
37402 | 37402 | { |
37403 | 37403 | "name": "direction", |
37404 | | - "description": "Can be either `asc` or `desc`. Ignored without `sort` parameter.", |
| 37404 | + "description": "The direction to sort results. Ignored without `sort` parameter.", |
37405 | 37405 | "in": "query", |
37406 | 37406 | "required": false, |
37407 | 37407 | "schema": { |
|
46946 | 46946 | }, |
46947 | 46947 | { |
46948 | 46948 | "name": "state", |
46949 | | - "description": "Indicates the state of the issues to return. Can be either `open`, `closed`, or `all`.", |
| 46949 | + "description": "Indicates the state of the issues to return.", |
46950 | 46950 | "in": "query", |
46951 | 46951 | "required": false, |
46952 | 46952 | "schema": { |
|
46964 | 46964 | }, |
46965 | 46965 | { |
46966 | 46966 | "name": "sort", |
46967 | | - "description": "What to sort results by. Can be either `created`, `updated`, `comments`.", |
| 46967 | + "description": "What to sort results by.", |
46968 | 46968 | "in": "query", |
46969 | 46969 | "required": false, |
46970 | 46970 | "schema": { |
|
47341 | 47341 | "parameters": [ |
47342 | 47342 | { |
47343 | 47343 | "name": "state", |
47344 | | - "description": "Indicates the state of the memberships to return. Can be either `active` or `pending`. If not specified, the API returns both active and pending memberships.", |
| 47344 | + "description": "Indicates the state of the memberships to return. If not specified, the API returns both active and pending memberships.", |
47345 | 47345 | "in": "query", |
47346 | 47346 | "required": false, |
47347 | 47347 | "schema": { |
|
49480 | 49480 | }, |
49481 | 49481 | { |
49482 | 49482 | "name": "state", |
49483 | | - "description": "Indicates the state of the projects to return. Can be either `open`, `closed`, or `all`.", |
| 49483 | + "description": "Indicates the state of the projects to return.", |
49484 | 49484 | "in": "query", |
49485 | 49485 | "required": false, |
49486 | 49486 | "schema": { |
|
60611 | 60611 | "description": "The outcome of the job.", |
60612 | 60612 | "example": "success", |
60613 | 60613 | "type": "string", |
60614 | | - "nullable": true |
| 60614 | + "nullable": true, |
| 60615 | + "enum": [ |
| 60616 | + "success", |
| 60617 | + "failure", |
| 60618 | + "neutral", |
| 60619 | + "cancelled", |
| 60620 | + "skipped", |
| 60621 | + "timed_out", |
| 60622 | + "action_required" |
| 60623 | + ] |
60615 | 60624 | }, |
60616 | 60625 | "started_at": { |
60617 | 60626 | "description": "The time that the job started, in ISO 8601 format.", |
|
71305 | 71314 | "readOnly": true |
71306 | 71315 | }, |
71307 | 71316 | "secret-scanning-alert-state": { |
71308 | | - "description": "Sets the state of the secret scanning alert. Can be either `open` or `resolved`. You must provide `resolution` when you set the state to `resolved`.", |
| 71317 | + "description": "Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`.", |
71309 | 71318 | "type": "string", |
71310 | 71319 | "enum": [ |
71311 | 71320 | "open", |
|
96045 | 96054 | } |
96046 | 96055 | }, |
96047 | 96056 | "code_scanning_forbidden_write": { |
96048 | | - "description": "Response if the repository is archived or if github advanced security is not enabled for this repository", |
| 96057 | + "description": "Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository", |
96049 | 96058 | "content": { |
96050 | 96059 | "application/json": { |
96051 | 96060 | "schema": { |
|
0 commit comments