|
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