|
1 | 1 | {
|
2 | 2 | "openapi": "3.0.3",
|
3 | 3 | "info": {
|
4 |
| - "version": "2.4.1", |
| 4 | + "version": "2.4.2", |
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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
|
|
5412 | 5412 | },
|
5413 | 5413 | "members_can_create_pages": {
|
5414 | 5414 | "type": "boolean",
|
5415 |
| - "description": "Toggles whether organization members can create GitHub Pages sites. Can be one of: \n\\* `true` - all organization members can create GitHub Pages sites. \n\\* `false` - no organization members can create GitHub Pages sites. Existing published sites will not be impacted. \nDefault: `true`. " |
| 5415 | + "description": "Toggles whether organization members can create GitHub Pages sites. Can be one of: \n\\* `true` - all organization members can create GitHub Pages sites. \n\\* `false` - no organization members can create GitHub Pages sites. Existing published sites will not be impacted. \nDefault: `true`. ", |
| 5416 | + "default": true |
5416 | 5417 | },
|
| 5418 | + "members_can_create_public_pages": { "type": "boolean" }, |
| 5419 | + "members_can_create_private_pages": { "type": "boolean" }, |
5417 | 5420 | "blog": {
|
5418 | 5421 | "type": "string",
|
5419 | 5422 | "example": "\"http://github.blog\""
|
@@ -16511,15 +16514,18 @@
|
16511 | 16514 | },
|
16512 | 16515 | "summary": {
|
16513 | 16516 | "type": "string",
|
| 16517 | + "maxLength": 65535, |
16514 | 16518 | "description": "The summary of the check run. This parameter supports Markdown."
|
16515 | 16519 | },
|
16516 | 16520 | "text": {
|
16517 | 16521 | "type": "string",
|
| 16522 | + "maxLength": 65535, |
16518 | 16523 | "description": "The details of the check run. This parameter supports Markdown."
|
16519 | 16524 | },
|
16520 | 16525 | "annotations": {
|
16521 | 16526 | "type": "array",
|
16522 | 16527 | "description": "Adds information from your analysis to specific lines of code. Annotations are visible on GitHub in the **Checks** and **Files changed** tab of the pull request. The Checks API limits the number of annotations to a maximum of 50 per API request. To create more than 50 annotations, you have to make multiple requests to the [Update a check run](https://docs.github.com/rest/reference/checks#update-a-check-run) endpoint. Each time you update the check run, annotations are appended to the list of annotations that already exist for the check run. For details about how you can view annotations on GitHub, see \"[About status checks](https://help.github.com/articles/about-status-checks#checks)\". See the [`annotations` object](https://docs.github.com/rest/reference/checks#annotations-object) description for details about how to use this parameter.",
|
| 16528 | + "maxItems": 50, |
16523 | 16529 | "items": {
|
16524 | 16530 | "type": "object",
|
16525 | 16531 | "properties": {
|
@@ -16598,27 +16604,44 @@
|
16598 | 16604 | "actions": {
|
16599 | 16605 | "type": "array",
|
16600 | 16606 | "description": "Displays a button on GitHub that can be clicked to alert your app to do additional tasks. For example, a code linting app can display a button that automatically fixes detected errors. The button created in this object is displayed after the check run completes. When a user clicks the button, GitHub sends the [`check_run.requested_action` webhook](https://docs.github.com/webhooks/event-payloads/#check_run) to your app. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. See the [`actions` object](https://docs.github.com/rest/reference/checks#actions-object) description. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\" To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\"",
|
| 16607 | + "maxItems": 3, |
16601 | 16608 | "items": {
|
16602 | 16609 | "type": "object",
|
16603 | 16610 | "properties": {
|
16604 | 16611 | "label": {
|
16605 | 16612 | "type": "string",
|
| 16613 | + "maxLength": 20, |
16606 | 16614 | "description": "The text to be displayed on a button in the web UI. The maximum size is 20 characters."
|
16607 | 16615 | },
|
16608 | 16616 | "description": {
|
16609 | 16617 | "type": "string",
|
| 16618 | + "maxLength": 40, |
16610 | 16619 | "description": "A short explanation of what this action would do. The maximum size is 40 characters."
|
16611 | 16620 | },
|
16612 | 16621 | "identifier": {
|
16613 | 16622 | "type": "string",
|
| 16623 | + "maxLength": 20, |
16614 | 16624 | "description": "A reference for the action on the integrator's system. The maximum size is 20 characters."
|
16615 | 16625 | }
|
16616 | 16626 | },
|
16617 | 16627 | "required": ["label", "description", "identifier"]
|
16618 | 16628 | }
|
16619 | 16629 | }
|
16620 | 16630 | },
|
16621 |
| - "required": ["name", "head_sha"] |
| 16631 | + "required": ["name", "head_sha"], |
| 16632 | + "anyOf": [ |
| 16633 | + { |
| 16634 | + "properties": { "status": { "enum": ["completed"] } }, |
| 16635 | + "required": ["conclusion"], |
| 16636 | + "additionalProperties": true |
| 16637 | + }, |
| 16638 | + { |
| 16639 | + "properties": { |
| 16640 | + "status": { "enum": ["queued", "in_progress"] } |
| 16641 | + }, |
| 16642 | + "additionalProperties": true |
| 16643 | + } |
| 16644 | + ] |
16622 | 16645 | },
|
16623 | 16646 | "examples": {
|
16624 | 16647 | "example-of-in-progress-conclusion": {
|
@@ -16822,15 +16845,18 @@
|
16822 | 16845 | },
|
16823 | 16846 | "summary": {
|
16824 | 16847 | "type": "string",
|
16825 |
| - "description": "Can contain Markdown." |
| 16848 | + "description": "Can contain Markdown.", |
| 16849 | + "maxLength": 65535 |
16826 | 16850 | },
|
16827 | 16851 | "text": {
|
16828 | 16852 | "type": "string",
|
16829 |
| - "description": "Can contain Markdown." |
| 16853 | + "description": "Can contain Markdown.", |
| 16854 | + "maxLength": 65535 |
16830 | 16855 | },
|
16831 | 16856 | "annotations": {
|
16832 | 16857 | "type": "array",
|
16833 | 16858 | "description": "Adds information from your analysis to specific lines of code. Annotations are visible in GitHub's pull request UI. Annotations are visible in GitHub's pull request UI. The Checks API limits the number of annotations to a maximum of 50 per API request. To create more than 50 annotations, you have to make multiple requests to the [Update a check run](https://docs.github.com/rest/reference/checks#update-a-check-run) endpoint. Each time you update the check run, annotations are appended to the list of annotations that already exist for the check run. For details about annotations in the UI, see \"[About status checks](https://help.github.com/articles/about-status-checks#checks)\". See the [`annotations` object](https://docs.github.com/rest/reference/checks#annotations-object-1) description for details.",
|
| 16859 | + "maxItems": 50, |
16834 | 16860 | "items": {
|
16835 | 16861 | "type": "object",
|
16836 | 16862 | "properties": {
|
@@ -16909,26 +16935,43 @@
|
16909 | 16935 | "actions": {
|
16910 | 16936 | "type": "array",
|
16911 | 16937 | "description": "Possible further actions the integrator can perform, which a user may trigger. Each action includes a `label`, `identifier` and `description`. A maximum of three actions are accepted. See the [`actions` object](https://docs.github.com/rest/reference/checks#actions-object) description. To learn more about check runs and requested actions, see \"[Check runs and requested actions](https://docs.github.com/rest/reference/checks#check-runs-and-requested-actions).\"",
|
| 16938 | + "maxItems": 3, |
16912 | 16939 | "items": {
|
16913 | 16940 | "type": "object",
|
16914 | 16941 | "properties": {
|
16915 | 16942 | "label": {
|
16916 | 16943 | "type": "string",
|
| 16944 | + "maxLength": 20, |
16917 | 16945 | "description": "The text to be displayed on a button in the web UI. The maximum size is 20 characters."
|
16918 | 16946 | },
|
16919 | 16947 | "description": {
|
16920 | 16948 | "type": "string",
|
| 16949 | + "maxLength": 40, |
16921 | 16950 | "description": "A short explanation of what this action would do. The maximum size is 40 characters."
|
16922 | 16951 | },
|
16923 | 16952 | "identifier": {
|
16924 | 16953 | "type": "string",
|
| 16954 | + "maxLength": 20, |
16925 | 16955 | "description": "A reference for the action on the integrator's system. The maximum size is 20 characters."
|
16926 | 16956 | }
|
16927 | 16957 | },
|
16928 | 16958 | "required": ["label", "description", "identifier"]
|
16929 | 16959 | }
|
16930 | 16960 | }
|
16931 |
| - } |
| 16961 | + }, |
| 16962 | + "anyOf": [ |
| 16963 | + { |
| 16964 | + "properties": { "status": { "enum": ["completed"] } }, |
| 16965 | + "required": ["conclusion"], |
| 16966 | + "additionalProperties": true |
| 16967 | + }, |
| 16968 | + { |
| 16969 | + "properties": { |
| 16970 | + "status": { "enum": ["queued", "in_progress"] } |
| 16971 | + }, |
| 16972 | + "additionalProperties": true |
| 16973 | + } |
| 16974 | + ] |
16932 | 16975 | },
|
16933 | 16976 | "example": {
|
16934 | 16977 | "name": "mighty_readme",
|
|
26528 | 26571 | "application/json": {
|
26529 | 26572 | "schema": {
|
26530 | 26573 | "type": "object",
|
| 26574 | + "nullable": true, |
26531 | 26575 | "properties": {
|
26532 | 26576 | "commit_title": {
|
26533 | 26577 | "type": "string",
|
|
27285 | 27329 | "application/json": {
|
27286 | 27330 | "schema": {
|
27287 | 27331 | "type": "object",
|
| 27332 | + "nullable": true, |
27288 | 27333 | "properties": {
|
27289 | 27334 | "expected_head_sha": {
|
27290 | 27335 | "type": "string",
|
|
0 commit comments