@octokit/openapi 14.0.0 → 14.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "14.0.0",
4
+ "version": "14.1.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": {
@@ -8773,7 +8773,7 @@
8773
8773
  "/feeds": {
8774
8774
  "get": {
8775
8775
  "summary": "Get feeds",
8776
- "description": "GitHub Enterprise Server provides several timeline resources in [Atom](http://en.wikipedia.org/wiki/Atom_(standard)) format. The Feeds API lists all the feeds available to the authenticated user:\n\n* **Timeline**: The GitHub Enterprise Server global public timeline\n* **User**: The public timeline for any user, using `uri_template`. For more information, see \"[Hypermedia](https://docs.github.com/enterprise-server@3.12/rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia).\"\n* **Current user public**: The public timeline for the authenticated user\n* **Current user**: The private timeline for the authenticated user\n* **Current user actor**: The private timeline for activity created by the authenticated user\n* **Current user organizations**: The private timeline for the organizations the authenticated user is a member of.\n* **Security advisories**: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub Enterprise Server.\n\n**Note**: Private feeds are only returned when [authenticating via Basic Auth](https://docs.github.com/enterprise-server@3.12/rest/overview/other-authentication-methods#basic-authentication) since current feed URIs use the older, non revocable auth tokens.",
8776
+ "description": "Lists the feeds available to the authenticated user. The response provides a URL for each feed. You can then get a specific feed by sending a request to one of the feed URLs.\n\n* **Timeline**: The GitHub Enterprise Server global public timeline\n* **User**: The public timeline for any user, using `uri_template`. For more information, see \"[Hypermedia](https://docs.github.com/enterprise-server@3.12/rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia).\"\n* **Current user public**: The public timeline for the authenticated user\n* **Current user**: The private timeline for the authenticated user\n* **Current user actor**: The private timeline for activity created by the authenticated user\n* **Current user organizations**: The private timeline for the organizations the authenticated user is a member of.\n* **Security advisories**: A collection of public announcements that provide information about security-related vulnerabilities in software on GitHub Enterprise Server.\n\nBy default, timeline resources are returned in JSON. You can specify the `application/atom+xml` type in the `Accept` header to return timeline resources in Atom format. For more information, see \"[Media types](https://docs.github.com/enterprise-server@3.12/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types).\"\n\n**Note**: Private feeds are only returned when [authenticating via Basic Auth](https://docs.github.com/enterprise-server@3.12/rest/overview/other-authentication-methods#basic-authentication) since current feed URIs use the older, non revocable auth tokens.",
8777
8777
  "tags": [
8778
8778
  "activity"
8779
8779
  ],
@@ -12307,7 +12307,7 @@
12307
12307
  "/organizations": {
12308
12308
  "get": {
12309
12309
  "summary": "List organizations",
12310
- "description": "Lists all organizations, in the order that they were created on GitHub Enterprise Server.\n\n**Note:** Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@3.12/rest/guides/using-pagination-in-the-rest-api#using-link-headers) to get the URL for the next page of organizations.",
12310
+ "description": "Lists all organizations, in the order that they were created.\n\n**Note:** Pagination is powered exclusively by the `since` parameter. Use the [Link header](https://docs.github.com/enterprise-server@3.12/rest/guides/using-pagination-in-the-rest-api#using-link-headers) to get the URL for the next page of organizations.",
12311
12311
  "tags": [
12312
12312
  "orgs"
12313
12313
  ],
@@ -34440,11 +34440,14 @@
34440
34440
  },
34441
34441
  "status": {
34442
34442
  "type": "string",
34443
- "description": "The current status.",
34443
+ "description": "The current status of the check run. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`.",
34444
34444
  "enum": [
34445
34445
  "queued",
34446
34446
  "in_progress",
34447
- "completed"
34447
+ "completed",
34448
+ "waiting",
34449
+ "requested",
34450
+ "pending"
34448
34451
  ]
34449
34452
  },
34450
34453
  "conclusion": {
@@ -37099,6 +37102,9 @@
37099
37102
  }
37100
37103
  }
37101
37104
  },
37105
+ "409": {
37106
+ "$ref": "#/components/responses/conflict"
37107
+ },
37102
37108
  "422": {
37103
37109
  "$ref": "#/components/responses/validation_failed"
37104
37110
  }
@@ -37330,6 +37336,9 @@
37330
37336
  "$ref": "#/components/headers/link"
37331
37337
  }
37332
37338
  }
37339
+ },
37340
+ "409": {
37341
+ "$ref": "#/components/responses/conflict"
37333
37342
  }
37334
37343
  },
37335
37344
  "x-github": {
@@ -37389,6 +37398,9 @@
37389
37398
  "404": {
37390
37399
  "$ref": "#/components/responses/not_found"
37391
37400
  },
37401
+ "409": {
37402
+ "$ref": "#/components/responses/conflict"
37403
+ },
37392
37404
  "422": {
37393
37405
  "$ref": "#/components/responses/validation_failed"
37394
37406
  },
@@ -37726,7 +37738,7 @@
37726
37738
  "/repos/{owner}/{repo}/compare/{basehead}": {
37727
37739
  "get": {
37728
37740
  "summary": "Compare two commits",
37729
- "description": "Compares two commits against one another. You can compare branches in the same repository, or you can compare branches that exist in different repositories within the same repository network, including fork branches. For more information about how to view a repository's network, see \"[Understanding connections between repositories](https://docs.github.com/enterprise-server@3.12/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories).\"\n\nThis endpoint is equivalent to running the `git log BASE..HEAD` command, but it returns commits in a different order. The `git log BASE..HEAD` command returns commits in reverse chronological order, whereas the API returns commits in chronological order.\n\nThis endpoint supports the following custom media types. For more information, see \"[Media types](https://docs.github.com/enterprise-server@3.12/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types).\"\n\n- **`application/vnd.github.diff`**: Returns the diff of the commit.\n- **`application/vnd.github.patch`**: Returns the patch of the commit. Diffs with binary data will have no `patch` property.\n\nThe API response includes details about the files that were changed between the two commits. This includes the status of the change (if a file was added, removed, modified, or renamed), and details of the change itself. For example, files with a `renamed` status have a `previous_filename` field showing the previous filename of the file, and files with a `modified` status have a `patch` field showing the changes made to the file.\n\nWhen calling this endpoint without any paging parameter (`per_page` or `page`), the returned list is limited to 250 commits, and the last commit in the list is the most recent of the entire comparison.\n\n**Working with large comparisons**\n\nTo process a response with a large number of commits, use a query parameter (`per_page` or `page`) to paginate the results. When using pagination:\n\n- The list of changed files is only shown on the first page of results, but it includes all changed files for the entire comparison.\n- The results are returned in chronological order, but the last commit in the returned list may not be the most recent one in the entire set if there are more pages of results.\n\nFor more information on working with pagination, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-server@3.12/rest/guides/using-pagination-in-the-rest-api).\"\n\n**Signature verification object**\n\nThe response will include a `verification` object that describes the result of verifying the commit's signature. The `verification` object includes the following fields:\n\n| Name | Type | Description |\n| ---- | ---- | ----------- |\n| `verified` | `boolean` | Indicates whether GitHub considers the signature in this commit to be verified. |\n| `reason` | `string` | The reason for verified value. Possible values and their meanings are enumerated in table below. |\n| `signature` | `string` | The signature that was extracted from the commit. |\n| `payload` | `string` | The value that was signed. |\n\nThese are the possible values for `reason` in the `verification` object:\n\n| Value | Description |\n| ----- | ----------- |\n| `expired_key` | The key that made the signature is expired. |\n| `not_signing_key` | The \"signing\" flag is not among the usage flags in the GPG key that made the signature. |\n| `gpgverify_error` | There was an error communicating with the signature verification service. |\n| `gpgverify_unavailable` | The signature verification service is currently unavailable. |\n| `unsigned` | The object does not include a signature. |\n| `unknown_signature_type` | A non-PGP signature was found in the commit. |\n| `no_user` | No user was associated with the `committer` email address in the commit. |\n| `unverified_email` | The `committer` email address in the commit was associated with a user, but the email address is not verified on their account. |\n| `bad_email` | The `committer` email address in the commit is not included in the identities of the PGP key that made the signature. |\n| `unknown_key` | The key that made the signature has not been registered with any user's account. |\n| `malformed_signature` | There was an error parsing the signature. |\n| `invalid` | The signature could not be cryptographically verified using the key whose key-id was found in the signature. |\n| `valid` | None of the above errors applied, so the signature is considered to be verified. |",
37741
+ "description": "Compares two commits against one another. You can compare refs (branches or tags) and commit SHAs in the same repository, or you can compare refs and commit SHAs that exist in different repositories within the same repository network, including fork branches. For more information about how to view a repository's network, see \"[Understanding connections between repositories](https://docs.github.com/enterprise-server@3.12/repositories/viewing-activity-and-data-for-your-repository/understanding-connections-between-repositories).\"\n\nThis endpoint is equivalent to running the `git log BASE..HEAD` command, but it returns commits in a different order. The `git log BASE..HEAD` command returns commits in reverse chronological order, whereas the API returns commits in chronological order.\n\nThis endpoint supports the following custom media types. For more information, see \"[Media types](https://docs.github.com/enterprise-server@3.12/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types).\"\n\n- **`application/vnd.github.diff`**: Returns the diff of the commit.\n- **`application/vnd.github.patch`**: Returns the patch of the commit. Diffs with binary data will have no `patch` property.\n\nThe API response includes details about the files that were changed between the two commits. This includes the status of the change (if a file was added, removed, modified, or renamed), and details of the change itself. For example, files with a `renamed` status have a `previous_filename` field showing the previous filename of the file, and files with a `modified` status have a `patch` field showing the changes made to the file.\n\nWhen calling this endpoint without any paging parameter (`per_page` or `page`), the returned list is limited to 250 commits, and the last commit in the list is the most recent of the entire comparison.\n\n**Working with large comparisons**\n\nTo process a response with a large number of commits, use a query parameter (`per_page` or `page`) to paginate the results. When using pagination:\n\n- The list of changed files is only shown on the first page of results, but it includes all changed files for the entire comparison.\n- The results are returned in chronological order, but the last commit in the returned list may not be the most recent one in the entire set if there are more pages of results.\n\nFor more information on working with pagination, see \"[Using pagination in the REST API](https://docs.github.com/enterprise-server@3.12/rest/guides/using-pagination-in-the-rest-api).\"\n\n**Signature verification object**\n\nThe response will include a `verification` object that describes the result of verifying the commit's signature. The `verification` object includes the following fields:\n\n| Name | Type | Description |\n| ---- | ---- | ----------- |\n| `verified` | `boolean` | Indicates whether GitHub considers the signature in this commit to be verified. |\n| `reason` | `string` | The reason for verified value. Possible values and their meanings are enumerated in table below. |\n| `signature` | `string` | The signature that was extracted from the commit. |\n| `payload` | `string` | The value that was signed. |\n\nThese are the possible values for `reason` in the `verification` object:\n\n| Value | Description |\n| ----- | ----------- |\n| `expired_key` | The key that made the signature is expired. |\n| `not_signing_key` | The \"signing\" flag is not among the usage flags in the GPG key that made the signature. |\n| `gpgverify_error` | There was an error communicating with the signature verification service. |\n| `gpgverify_unavailable` | The signature verification service is currently unavailable. |\n| `unsigned` | The object does not include a signature. |\n| `unknown_signature_type` | A non-PGP signature was found in the commit. |\n| `no_user` | No user was associated with the `committer` email address in the commit. |\n| `unverified_email` | The `committer` email address in the commit was associated with a user, but the email address is not verified on their account. |\n| `bad_email` | The `committer` email address in the commit is not included in the identities of the PGP key that made the signature. |\n| `unknown_key` | The key that made the signature has not been registered with any user's account. |\n| `malformed_signature` | There was an error parsing the signature. |\n| `invalid` | The signature could not be cryptographically verified using the key whose key-id was found in the signature. |\n| `valid` | None of the above errors applied, so the signature is considered to be verified. |",
37730
37742
  "tags": [
37731
37743
  "repos"
37732
37744
  ],
@@ -40667,6 +40679,616 @@
40667
40679
  "x-octokit": {}
40668
40680
  }
40669
40681
  },
40682
+ "/repos/{owner}/{repo}/environments/{environment_name}/secrets": {
40683
+ "get": {
40684
+ "summary": "List environment secrets",
40685
+ "description": "Lists all secrets available in an environment without revealing their\nencrypted values.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40686
+ "tags": [
40687
+ "actions"
40688
+ ],
40689
+ "operationId": "actions/list-environment-secrets",
40690
+ "externalDocs": {
40691
+ "description": "API method documentation",
40692
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#list-environment-secrets"
40693
+ },
40694
+ "parameters": [
40695
+ {
40696
+ "$ref": "#/components/parameters/owner"
40697
+ },
40698
+ {
40699
+ "$ref": "#/components/parameters/repo"
40700
+ },
40701
+ {
40702
+ "$ref": "#/components/parameters/environment-name"
40703
+ },
40704
+ {
40705
+ "$ref": "#/components/parameters/per-page"
40706
+ },
40707
+ {
40708
+ "$ref": "#/components/parameters/page"
40709
+ }
40710
+ ],
40711
+ "responses": {
40712
+ "200": {
40713
+ "description": "Response",
40714
+ "content": {
40715
+ "application/json": {
40716
+ "schema": {
40717
+ "type": "object",
40718
+ "required": [
40719
+ "total_count",
40720
+ "secrets"
40721
+ ],
40722
+ "properties": {
40723
+ "total_count": {
40724
+ "type": "integer"
40725
+ },
40726
+ "secrets": {
40727
+ "type": "array",
40728
+ "items": {
40729
+ "$ref": "#/components/schemas/actions-secret"
40730
+ }
40731
+ }
40732
+ }
40733
+ },
40734
+ "examples": {
40735
+ "default": {
40736
+ "$ref": "#/components/examples/actions-secret-paginated"
40737
+ }
40738
+ }
40739
+ }
40740
+ },
40741
+ "headers": {
40742
+ "Link": {
40743
+ "$ref": "#/components/headers/link"
40744
+ }
40745
+ }
40746
+ }
40747
+ },
40748
+ "x-github": {
40749
+ "githubCloudOnly": false,
40750
+ "enabledForGitHubApps": true,
40751
+ "category": "actions",
40752
+ "subcategory": "secrets"
40753
+ },
40754
+ "x-octokit": {}
40755
+ }
40756
+ },
40757
+ "/repos/{owner}/{repo}/environments/{environment_name}/secrets/public-key": {
40758
+ "get": {
40759
+ "summary": "Get an environment public key",
40760
+ "description": "Get the public key for an environment, which you need to encrypt environment\nsecrets. You need to encrypt a secret before you can create or update secrets.\n\nAnyone with read access to the repository can use this endpoint.\n\nIf the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40761
+ "tags": [
40762
+ "actions"
40763
+ ],
40764
+ "operationId": "actions/get-environment-public-key",
40765
+ "externalDocs": {
40766
+ "description": "API method documentation",
40767
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-public-key"
40768
+ },
40769
+ "parameters": [
40770
+ {
40771
+ "$ref": "#/components/parameters/owner"
40772
+ },
40773
+ {
40774
+ "$ref": "#/components/parameters/repo"
40775
+ },
40776
+ {
40777
+ "$ref": "#/components/parameters/environment-name"
40778
+ }
40779
+ ],
40780
+ "responses": {
40781
+ "200": {
40782
+ "description": "Response",
40783
+ "content": {
40784
+ "application/json": {
40785
+ "schema": {
40786
+ "$ref": "#/components/schemas/actions-public-key"
40787
+ },
40788
+ "examples": {
40789
+ "default": {
40790
+ "$ref": "#/components/examples/actions-public-key"
40791
+ }
40792
+ }
40793
+ }
40794
+ }
40795
+ }
40796
+ },
40797
+ "x-github": {
40798
+ "githubCloudOnly": false,
40799
+ "enabledForGitHubApps": true,
40800
+ "category": "actions",
40801
+ "subcategory": "secrets"
40802
+ },
40803
+ "x-octokit": {}
40804
+ }
40805
+ },
40806
+ "/repos/{owner}/{repo}/environments/{environment_name}/secrets/{secret_name}": {
40807
+ "get": {
40808
+ "summary": "Get an environment secret",
40809
+ "description": "Gets a single environment secret without revealing its encrypted value.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40810
+ "tags": [
40811
+ "actions"
40812
+ ],
40813
+ "operationId": "actions/get-environment-secret",
40814
+ "externalDocs": {
40815
+ "description": "API method documentation",
40816
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-secret"
40817
+ },
40818
+ "parameters": [
40819
+ {
40820
+ "$ref": "#/components/parameters/owner"
40821
+ },
40822
+ {
40823
+ "$ref": "#/components/parameters/repo"
40824
+ },
40825
+ {
40826
+ "$ref": "#/components/parameters/environment-name"
40827
+ },
40828
+ {
40829
+ "$ref": "#/components/parameters/secret-name"
40830
+ }
40831
+ ],
40832
+ "responses": {
40833
+ "200": {
40834
+ "description": "Response",
40835
+ "content": {
40836
+ "application/json": {
40837
+ "schema": {
40838
+ "$ref": "#/components/schemas/actions-secret"
40839
+ },
40840
+ "examples": {
40841
+ "default": {
40842
+ "$ref": "#/components/examples/actions-secret"
40843
+ }
40844
+ }
40845
+ }
40846
+ }
40847
+ }
40848
+ },
40849
+ "x-github": {
40850
+ "githubCloudOnly": false,
40851
+ "enabledForGitHubApps": true,
40852
+ "category": "actions",
40853
+ "subcategory": "secrets"
40854
+ },
40855
+ "x-octokit": {}
40856
+ },
40857
+ "put": {
40858
+ "summary": "Create or update an environment secret",
40859
+ "description": "Creates or updates an environment secret with an encrypted value. Encrypt your secret using\n[LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see \"[Encrypting secrets for the REST API](https://docs.github.com/enterprise-server@3.12/rest/guides/encrypting-secrets-for-the-rest-api).\"\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40860
+ "tags": [
40861
+ "actions"
40862
+ ],
40863
+ "operationId": "actions/create-or-update-environment-secret",
40864
+ "externalDocs": {
40865
+ "description": "API method documentation",
40866
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#create-or-update-an-environment-secret"
40867
+ },
40868
+ "parameters": [
40869
+ {
40870
+ "$ref": "#/components/parameters/owner"
40871
+ },
40872
+ {
40873
+ "$ref": "#/components/parameters/repo"
40874
+ },
40875
+ {
40876
+ "$ref": "#/components/parameters/environment-name"
40877
+ },
40878
+ {
40879
+ "$ref": "#/components/parameters/secret-name"
40880
+ }
40881
+ ],
40882
+ "requestBody": {
40883
+ "required": true,
40884
+ "content": {
40885
+ "application/json": {
40886
+ "schema": {
40887
+ "type": "object",
40888
+ "properties": {
40889
+ "encrypted_value": {
40890
+ "type": "string",
40891
+ "description": "Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get an environment public key](https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-public-key) endpoint.",
40892
+ "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
40893
+ },
40894
+ "key_id": {
40895
+ "type": "string",
40896
+ "description": "ID of the key you used to encrypt the secret."
40897
+ }
40898
+ },
40899
+ "required": [
40900
+ "encrypted_value",
40901
+ "key_id"
40902
+ ]
40903
+ },
40904
+ "examples": {
40905
+ "default": {
40906
+ "value": {
40907
+ "encrypted_value": "c2VjcmV0",
40908
+ "key_id": "012345678912345678"
40909
+ }
40910
+ }
40911
+ }
40912
+ }
40913
+ }
40914
+ },
40915
+ "responses": {
40916
+ "201": {
40917
+ "description": "Response when creating a secret",
40918
+ "content": {
40919
+ "application/json": {
40920
+ "schema": {
40921
+ "$ref": "#/components/schemas/empty-object"
40922
+ },
40923
+ "examples": {
40924
+ "default": {
40925
+ "value": null
40926
+ }
40927
+ }
40928
+ }
40929
+ }
40930
+ },
40931
+ "204": {
40932
+ "description": "Response when updating a secret"
40933
+ }
40934
+ },
40935
+ "x-github": {
40936
+ "githubCloudOnly": false,
40937
+ "enabledForGitHubApps": true,
40938
+ "category": "actions",
40939
+ "subcategory": "secrets"
40940
+ },
40941
+ "x-octokit": {}
40942
+ },
40943
+ "delete": {
40944
+ "summary": "Delete an environment secret",
40945
+ "description": "Deletes a secret in an environment using the secret name.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40946
+ "tags": [
40947
+ "actions"
40948
+ ],
40949
+ "operationId": "actions/delete-environment-secret",
40950
+ "externalDocs": {
40951
+ "description": "API method documentation",
40952
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#delete-an-environment-secret"
40953
+ },
40954
+ "parameters": [
40955
+ {
40956
+ "$ref": "#/components/parameters/owner"
40957
+ },
40958
+ {
40959
+ "$ref": "#/components/parameters/repo"
40960
+ },
40961
+ {
40962
+ "$ref": "#/components/parameters/environment-name"
40963
+ },
40964
+ {
40965
+ "$ref": "#/components/parameters/secret-name"
40966
+ }
40967
+ ],
40968
+ "responses": {
40969
+ "204": {
40970
+ "description": "Default response"
40971
+ }
40972
+ },
40973
+ "x-github": {
40974
+ "githubCloudOnly": false,
40975
+ "enabledForGitHubApps": true,
40976
+ "category": "actions",
40977
+ "subcategory": "secrets"
40978
+ },
40979
+ "x-octokit": {}
40980
+ }
40981
+ },
40982
+ "/repos/{owner}/{repo}/environments/{environment_name}/variables": {
40983
+ "get": {
40984
+ "summary": "List environment variables",
40985
+ "description": "Lists all environment variables.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
40986
+ "tags": [
40987
+ "actions"
40988
+ ],
40989
+ "operationId": "actions/list-environment-variables",
40990
+ "externalDocs": {
40991
+ "description": "API method documentation",
40992
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#list-environment-variables"
40993
+ },
40994
+ "parameters": [
40995
+ {
40996
+ "$ref": "#/components/parameters/owner"
40997
+ },
40998
+ {
40999
+ "$ref": "#/components/parameters/repo"
41000
+ },
41001
+ {
41002
+ "$ref": "#/components/parameters/environment-name"
41003
+ },
41004
+ {
41005
+ "$ref": "#/components/parameters/variables-per-page"
41006
+ },
41007
+ {
41008
+ "$ref": "#/components/parameters/page"
41009
+ }
41010
+ ],
41011
+ "responses": {
41012
+ "200": {
41013
+ "description": "Response",
41014
+ "content": {
41015
+ "application/json": {
41016
+ "schema": {
41017
+ "type": "object",
41018
+ "required": [
41019
+ "total_count",
41020
+ "variables"
41021
+ ],
41022
+ "properties": {
41023
+ "total_count": {
41024
+ "type": "integer"
41025
+ },
41026
+ "variables": {
41027
+ "type": "array",
41028
+ "items": {
41029
+ "$ref": "#/components/schemas/actions-variable"
41030
+ }
41031
+ }
41032
+ }
41033
+ },
41034
+ "examples": {
41035
+ "default": {
41036
+ "$ref": "#/components/examples/actions-variables-paginated"
41037
+ }
41038
+ }
41039
+ }
41040
+ },
41041
+ "headers": {
41042
+ "Link": {
41043
+ "$ref": "#/components/headers/link"
41044
+ }
41045
+ }
41046
+ }
41047
+ },
41048
+ "x-github": {
41049
+ "githubCloudOnly": false,
41050
+ "enabledForGitHubApps": true,
41051
+ "category": "actions",
41052
+ "subcategory": "variables"
41053
+ },
41054
+ "x-octokit": {}
41055
+ },
41056
+ "post": {
41057
+ "summary": "Create an environment variable",
41058
+ "description": "Create an environment variable that you can reference in a GitHub Actions workflow.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
41059
+ "tags": [
41060
+ "actions"
41061
+ ],
41062
+ "operationId": "actions/create-environment-variable",
41063
+ "externalDocs": {
41064
+ "description": "API method documentation",
41065
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#create-an-environment-variable"
41066
+ },
41067
+ "parameters": [
41068
+ {
41069
+ "$ref": "#/components/parameters/owner"
41070
+ },
41071
+ {
41072
+ "$ref": "#/components/parameters/repo"
41073
+ },
41074
+ {
41075
+ "$ref": "#/components/parameters/environment-name"
41076
+ }
41077
+ ],
41078
+ "requestBody": {
41079
+ "required": true,
41080
+ "content": {
41081
+ "application/json": {
41082
+ "schema": {
41083
+ "type": "object",
41084
+ "properties": {
41085
+ "name": {
41086
+ "type": "string",
41087
+ "description": "The name of the variable."
41088
+ },
41089
+ "value": {
41090
+ "type": "string",
41091
+ "description": "The value of the variable."
41092
+ }
41093
+ },
41094
+ "required": [
41095
+ "name",
41096
+ "value"
41097
+ ]
41098
+ },
41099
+ "examples": {
41100
+ "default": {
41101
+ "value": {
41102
+ "name": "USERNAME",
41103
+ "value": "octocat"
41104
+ }
41105
+ }
41106
+ }
41107
+ }
41108
+ }
41109
+ },
41110
+ "responses": {
41111
+ "201": {
41112
+ "description": "Response",
41113
+ "content": {
41114
+ "application/json": {
41115
+ "schema": {
41116
+ "$ref": "#/components/schemas/empty-object"
41117
+ },
41118
+ "examples": {
41119
+ "default": {
41120
+ "value": null
41121
+ }
41122
+ }
41123
+ }
41124
+ }
41125
+ }
41126
+ },
41127
+ "x-github": {
41128
+ "githubCloudOnly": false,
41129
+ "enabledForGitHubApps": true,
41130
+ "category": "actions",
41131
+ "subcategory": "variables"
41132
+ },
41133
+ "x-octokit": {}
41134
+ }
41135
+ },
41136
+ "/repos/{owner}/{repo}/environments/{environment_name}/variables/{name}": {
41137
+ "get": {
41138
+ "summary": "Get an environment variable",
41139
+ "description": "Gets a specific variable in an environment.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
41140
+ "tags": [
41141
+ "actions"
41142
+ ],
41143
+ "operationId": "actions/get-environment-variable",
41144
+ "externalDocs": {
41145
+ "description": "API method documentation",
41146
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#get-an-environment-variable"
41147
+ },
41148
+ "parameters": [
41149
+ {
41150
+ "$ref": "#/components/parameters/owner"
41151
+ },
41152
+ {
41153
+ "$ref": "#/components/parameters/repo"
41154
+ },
41155
+ {
41156
+ "$ref": "#/components/parameters/environment-name"
41157
+ },
41158
+ {
41159
+ "$ref": "#/components/parameters/variable-name"
41160
+ }
41161
+ ],
41162
+ "responses": {
41163
+ "200": {
41164
+ "description": "Response",
41165
+ "content": {
41166
+ "application/json": {
41167
+ "schema": {
41168
+ "$ref": "#/components/schemas/actions-variable"
41169
+ },
41170
+ "examples": {
41171
+ "default": {
41172
+ "$ref": "#/components/examples/actions-variable"
41173
+ }
41174
+ }
41175
+ }
41176
+ }
41177
+ }
41178
+ },
41179
+ "x-github": {
41180
+ "githubCloudOnly": false,
41181
+ "enabledForGitHubApps": true,
41182
+ "category": "actions",
41183
+ "subcategory": "variables"
41184
+ },
41185
+ "x-octokit": {}
41186
+ },
41187
+ "patch": {
41188
+ "summary": "Update an environment variable",
41189
+ "description": "Updates an environment variable that you can reference in a GitHub Actions workflow.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
41190
+ "tags": [
41191
+ "actions"
41192
+ ],
41193
+ "operationId": "actions/update-environment-variable",
41194
+ "externalDocs": {
41195
+ "description": "API method documentation",
41196
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#update-an-environment-variable"
41197
+ },
41198
+ "parameters": [
41199
+ {
41200
+ "$ref": "#/components/parameters/owner"
41201
+ },
41202
+ {
41203
+ "$ref": "#/components/parameters/repo"
41204
+ },
41205
+ {
41206
+ "$ref": "#/components/parameters/variable-name"
41207
+ },
41208
+ {
41209
+ "$ref": "#/components/parameters/environment-name"
41210
+ }
41211
+ ],
41212
+ "requestBody": {
41213
+ "required": true,
41214
+ "content": {
41215
+ "application/json": {
41216
+ "schema": {
41217
+ "type": "object",
41218
+ "properties": {
41219
+ "name": {
41220
+ "type": "string",
41221
+ "description": "The name of the variable."
41222
+ },
41223
+ "value": {
41224
+ "type": "string",
41225
+ "description": "The value of the variable."
41226
+ }
41227
+ }
41228
+ },
41229
+ "examples": {
41230
+ "default": {
41231
+ "value": {
41232
+ "name": "USERNAME",
41233
+ "value": "octocat"
41234
+ }
41235
+ }
41236
+ }
41237
+ }
41238
+ }
41239
+ },
41240
+ "responses": {
41241
+ "204": {
41242
+ "description": "Response"
41243
+ }
41244
+ },
41245
+ "x-github": {
41246
+ "githubCloudOnly": false,
41247
+ "enabledForGitHubApps": true,
41248
+ "category": "actions",
41249
+ "subcategory": "variables"
41250
+ },
41251
+ "x-octokit": {}
41252
+ },
41253
+ "delete": {
41254
+ "summary": "Delete an environment variable",
41255
+ "description": "Deletes an environment variable using the variable name.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
41256
+ "tags": [
41257
+ "actions"
41258
+ ],
41259
+ "operationId": "actions/delete-environment-variable",
41260
+ "externalDocs": {
41261
+ "description": "API method documentation",
41262
+ "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#delete-an-environment-variable"
41263
+ },
41264
+ "parameters": [
41265
+ {
41266
+ "$ref": "#/components/parameters/owner"
41267
+ },
41268
+ {
41269
+ "$ref": "#/components/parameters/repo"
41270
+ },
41271
+ {
41272
+ "$ref": "#/components/parameters/variable-name"
41273
+ },
41274
+ {
41275
+ "$ref": "#/components/parameters/environment-name"
41276
+ }
41277
+ ],
41278
+ "responses": {
41279
+ "204": {
41280
+ "description": "Response"
41281
+ }
41282
+ },
41283
+ "x-github": {
41284
+ "githubCloudOnly": false,
41285
+ "enabledForGitHubApps": true,
41286
+ "category": "actions",
41287
+ "subcategory": "variables"
41288
+ },
41289
+ "x-octokit": {}
41290
+ }
41291
+ },
40670
41292
  "/repos/{owner}/{repo}/events": {
40671
41293
  "get": {
40672
41294
  "summary": "List repository events",
@@ -41039,6 +41661,9 @@
41039
41661
  "404": {
41040
41662
  "$ref": "#/components/responses/not_found"
41041
41663
  },
41664
+ "409": {
41665
+ "$ref": "#/components/responses/conflict"
41666
+ },
41042
41667
  "422": {
41043
41668
  "$ref": "#/components/responses/validation_failed"
41044
41669
  }
@@ -41193,6 +41818,9 @@
41193
41818
  "404": {
41194
41819
  "$ref": "#/components/responses/not_found"
41195
41820
  },
41821
+ "409": {
41822
+ "$ref": "#/components/responses/conflict"
41823
+ },
41196
41824
  "422": {
41197
41825
  "$ref": "#/components/responses/validation_failed"
41198
41826
  }
@@ -41247,6 +41875,9 @@
41247
41875
  },
41248
41876
  "404": {
41249
41877
  "$ref": "#/components/responses/not_found"
41878
+ },
41879
+ "409": {
41880
+ "$ref": "#/components/responses/conflict"
41250
41881
  }
41251
41882
  },
41252
41883
  "x-github": {
@@ -41278,7 +41909,7 @@
41278
41909
  "$ref": "#/components/parameters/repo"
41279
41910
  },
41280
41911
  {
41281
- "$ref": "#/components/parameters/commit-ref"
41912
+ "$ref": "#/components/parameters/git-ref-only"
41282
41913
  }
41283
41914
  ],
41284
41915
  "responses": {
@@ -41304,6 +41935,9 @@
41304
41935
  "$ref": "#/components/headers/link"
41305
41936
  }
41306
41937
  }
41938
+ },
41939
+ "409": {
41940
+ "$ref": "#/components/responses/conflict"
41307
41941
  }
41308
41942
  },
41309
41943
  "x-github": {
@@ -41335,7 +41969,7 @@
41335
41969
  "$ref": "#/components/parameters/repo"
41336
41970
  },
41337
41971
  {
41338
- "$ref": "#/components/parameters/commit-ref"
41972
+ "$ref": "#/components/parameters/git-ref-only"
41339
41973
  }
41340
41974
  ],
41341
41975
  "responses": {
@@ -41356,6 +41990,9 @@
41356
41990
  },
41357
41991
  "404": {
41358
41992
  "$ref": "#/components/responses/not_found"
41993
+ },
41994
+ "409": {
41995
+ "$ref": "#/components/responses/conflict"
41359
41996
  }
41360
41997
  },
41361
41998
  "x-github": {
@@ -41443,6 +42080,9 @@
41443
42080
  }
41444
42081
  }
41445
42082
  },
42083
+ "409": {
42084
+ "$ref": "#/components/responses/conflict"
42085
+ },
41446
42086
  "422": {
41447
42087
  "$ref": "#/components/responses/validation_failed"
41448
42088
  }
@@ -41459,7 +42099,7 @@
41459
42099
  "/repos/{owner}/{repo}/git/refs/{ref}": {
41460
42100
  "patch": {
41461
42101
  "summary": "Update a reference",
41462
- "description": "",
42102
+ "description": "Updates the provided reference to point to a new SHA. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation.",
41463
42103
  "tags": [
41464
42104
  "git"
41465
42105
  ],
@@ -41476,15 +42116,7 @@
41476
42116
  "$ref": "#/components/parameters/repo"
41477
42117
  },
41478
42118
  {
41479
- "name": "ref",
41480
- "description": "The name of the reference to update (for example, `heads/featureA`). Can be a branch name (`heads/BRANCH_NAME`) or tag name (`tags/TAG_NAME`). For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation.",
41481
- "in": "path",
41482
- "required": true,
41483
- "example": "heads/featureA",
41484
- "schema": {
41485
- "type": "string"
41486
- },
41487
- "x-multi-segment": true
42119
+ "$ref": "#/components/parameters/git-ref-only"
41488
42120
  }
41489
42121
  ],
41490
42122
  "requestBody": {
@@ -41535,6 +42167,9 @@
41535
42167
  }
41536
42168
  }
41537
42169
  },
42170
+ "409": {
42171
+ "$ref": "#/components/responses/conflict"
42172
+ },
41538
42173
  "422": {
41539
42174
  "$ref": "#/components/responses/validation_failed"
41540
42175
  }
@@ -41549,7 +42184,7 @@
41549
42184
  },
41550
42185
  "delete": {
41551
42186
  "summary": "Delete a reference",
41552
- "description": "",
42187
+ "description": "Deletes the provided reference.",
41553
42188
  "tags": [
41554
42189
  "git"
41555
42190
  ],
@@ -41566,13 +42201,16 @@
41566
42201
  "$ref": "#/components/parameters/repo"
41567
42202
  },
41568
42203
  {
41569
- "$ref": "#/components/parameters/commit-ref"
42204
+ "$ref": "#/components/parameters/git-ref-only"
41570
42205
  }
41571
42206
  ],
41572
42207
  "responses": {
41573
42208
  "204": {
41574
42209
  "description": "Response"
41575
42210
  },
42211
+ "409": {
42212
+ "$ref": "#/components/responses/conflict"
42213
+ },
41576
42214
  "422": {
41577
42215
  "$ref": "#/components/responses/validation_failed"
41578
42216
  }
@@ -41707,6 +42345,9 @@
41707
42345
  }
41708
42346
  }
41709
42347
  },
42348
+ "409": {
42349
+ "$ref": "#/components/responses/conflict"
42350
+ },
41710
42351
  "422": {
41711
42352
  "$ref": "#/components/responses/validation_failed"
41712
42353
  }
@@ -41766,6 +42407,9 @@
41766
42407
  },
41767
42408
  "404": {
41768
42409
  "$ref": "#/components/responses/not_found"
42410
+ },
42411
+ "409": {
42412
+ "$ref": "#/components/responses/conflict"
41769
42413
  }
41770
42414
  },
41771
42415
  "x-github": {
@@ -41903,6 +42547,9 @@
41903
42547
  "404": {
41904
42548
  "$ref": "#/components/responses/not_found"
41905
42549
  },
42550
+ "409": {
42551
+ "$ref": "#/components/responses/conflict"
42552
+ },
41906
42553
  "422": {
41907
42554
  "$ref": "#/components/responses/validation_failed"
41908
42555
  }
@@ -41977,6 +42624,9 @@
41977
42624
  "404": {
41978
42625
  "$ref": "#/components/responses/not_found"
41979
42626
  },
42627
+ "409": {
42628
+ "$ref": "#/components/responses/conflict"
42629
+ },
41980
42630
  "422": {
41981
42631
  "$ref": "#/components/responses/validation_failed"
41982
42632
  }
@@ -54490,587 +55140,7 @@
54490
55140
  "x-octokit": {}
54491
55141
  }
54492
55142
  },
54493
- "/repositories/{repository_id}/environments/{environment_name}/secrets": {
54494
- "get": {
54495
- "summary": "List environment secrets",
54496
- "description": "Lists all secrets available in an environment without revealing their\nencrypted values.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54497
- "tags": [
54498
- "actions"
54499
- ],
54500
- "operationId": "actions/list-environment-secrets",
54501
- "externalDocs": {
54502
- "description": "API method documentation",
54503
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#list-environment-secrets"
54504
- },
54505
- "parameters": [
54506
- {
54507
- "$ref": "#/components/parameters/repository-id"
54508
- },
54509
- {
54510
- "$ref": "#/components/parameters/environment-name"
54511
- },
54512
- {
54513
- "$ref": "#/components/parameters/per-page"
54514
- },
54515
- {
54516
- "$ref": "#/components/parameters/page"
54517
- }
54518
- ],
54519
- "responses": {
54520
- "200": {
54521
- "description": "Response",
54522
- "content": {
54523
- "application/json": {
54524
- "schema": {
54525
- "type": "object",
54526
- "required": [
54527
- "total_count",
54528
- "secrets"
54529
- ],
54530
- "properties": {
54531
- "total_count": {
54532
- "type": "integer"
54533
- },
54534
- "secrets": {
54535
- "type": "array",
54536
- "items": {
54537
- "$ref": "#/components/schemas/actions-secret"
54538
- }
54539
- }
54540
- }
54541
- },
54542
- "examples": {
54543
- "default": {
54544
- "$ref": "#/components/examples/actions-secret-paginated"
54545
- }
54546
- }
54547
- }
54548
- },
54549
- "headers": {
54550
- "Link": {
54551
- "$ref": "#/components/headers/link"
54552
- }
54553
- }
54554
- }
54555
- },
54556
- "x-github": {
54557
- "githubCloudOnly": false,
54558
- "enabledForGitHubApps": true,
54559
- "category": "actions",
54560
- "subcategory": "secrets"
54561
- },
54562
- "x-octokit": {}
54563
- }
54564
- },
54565
- "/repositories/{repository_id}/environments/{environment_name}/secrets/public-key": {
54566
- "get": {
54567
- "summary": "Get an environment public key",
54568
- "description": "Get the public key for an environment, which you need to encrypt environment\nsecrets. You need to encrypt a secret before you can create or update secrets.\n\nAnyone with read access to the repository can use this endpoint.\n\nIf the repository is private, OAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54569
- "tags": [
54570
- "actions"
54571
- ],
54572
- "operationId": "actions/get-environment-public-key",
54573
- "externalDocs": {
54574
- "description": "API method documentation",
54575
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-public-key"
54576
- },
54577
- "parameters": [
54578
- {
54579
- "$ref": "#/components/parameters/repository-id"
54580
- },
54581
- {
54582
- "$ref": "#/components/parameters/environment-name"
54583
- }
54584
- ],
54585
- "responses": {
54586
- "200": {
54587
- "description": "Response",
54588
- "content": {
54589
- "application/json": {
54590
- "schema": {
54591
- "$ref": "#/components/schemas/actions-public-key"
54592
- },
54593
- "examples": {
54594
- "default": {
54595
- "$ref": "#/components/examples/actions-public-key"
54596
- }
54597
- }
54598
- }
54599
- }
54600
- }
54601
- },
54602
- "x-github": {
54603
- "githubCloudOnly": false,
54604
- "enabledForGitHubApps": true,
54605
- "category": "actions",
54606
- "subcategory": "secrets"
54607
- },
54608
- "x-octokit": {}
54609
- }
54610
- },
54611
- "/repositories/{repository_id}/environments/{environment_name}/secrets/{secret_name}": {
54612
- "get": {
54613
- "summary": "Get an environment secret",
54614
- "description": "Gets a single environment secret without revealing its encrypted value.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54615
- "tags": [
54616
- "actions"
54617
- ],
54618
- "operationId": "actions/get-environment-secret",
54619
- "externalDocs": {
54620
- "description": "API method documentation",
54621
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-secret"
54622
- },
54623
- "parameters": [
54624
- {
54625
- "$ref": "#/components/parameters/repository-id"
54626
- },
54627
- {
54628
- "$ref": "#/components/parameters/environment-name"
54629
- },
54630
- {
54631
- "$ref": "#/components/parameters/secret-name"
54632
- }
54633
- ],
54634
- "responses": {
54635
- "200": {
54636
- "description": "Response",
54637
- "content": {
54638
- "application/json": {
54639
- "schema": {
54640
- "$ref": "#/components/schemas/actions-secret"
54641
- },
54642
- "examples": {
54643
- "default": {
54644
- "$ref": "#/components/examples/actions-secret"
54645
- }
54646
- }
54647
- }
54648
- }
54649
- }
54650
- },
54651
- "x-github": {
54652
- "githubCloudOnly": false,
54653
- "enabledForGitHubApps": true,
54654
- "category": "actions",
54655
- "subcategory": "secrets"
54656
- },
54657
- "x-octokit": {}
54658
- },
54659
- "put": {
54660
- "summary": "Create or update an environment secret",
54661
- "description": "Creates or updates an environment secret with an encrypted value. Encrypt your secret using\n[LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages). For more information, see \"[Encrypting secrets for the REST API](https://docs.github.com/enterprise-server@3.12/rest/guides/encrypting-secrets-for-the-rest-api).\"\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54662
- "tags": [
54663
- "actions"
54664
- ],
54665
- "operationId": "actions/create-or-update-environment-secret",
54666
- "externalDocs": {
54667
- "description": "API method documentation",
54668
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#create-or-update-an-environment-secret"
54669
- },
54670
- "parameters": [
54671
- {
54672
- "$ref": "#/components/parameters/repository-id"
54673
- },
54674
- {
54675
- "$ref": "#/components/parameters/environment-name"
54676
- },
54677
- {
54678
- "$ref": "#/components/parameters/secret-name"
54679
- }
54680
- ],
54681
- "requestBody": {
54682
- "required": true,
54683
- "content": {
54684
- "application/json": {
54685
- "schema": {
54686
- "type": "object",
54687
- "properties": {
54688
- "encrypted_value": {
54689
- "type": "string",
54690
- "description": "Value for your secret, encrypted with [LibSodium](https://libsodium.gitbook.io/doc/bindings_for_other_languages) using the public key retrieved from the [Get an environment public key](https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#get-an-environment-public-key) endpoint.",
54691
- "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})$"
54692
- },
54693
- "key_id": {
54694
- "type": "string",
54695
- "description": "ID of the key you used to encrypt the secret."
54696
- }
54697
- },
54698
- "required": [
54699
- "encrypted_value",
54700
- "key_id"
54701
- ]
54702
- },
54703
- "examples": {
54704
- "default": {
54705
- "value": {
54706
- "encrypted_value": "c2VjcmV0",
54707
- "key_id": "012345678912345678"
54708
- }
54709
- }
54710
- }
54711
- }
54712
- }
54713
- },
54714
- "responses": {
54715
- "201": {
54716
- "description": "Response when creating a secret",
54717
- "content": {
54718
- "application/json": {
54719
- "schema": {
54720
- "$ref": "#/components/schemas/empty-object"
54721
- },
54722
- "examples": {
54723
- "default": {
54724
- "value": null
54725
- }
54726
- }
54727
- }
54728
- }
54729
- },
54730
- "204": {
54731
- "description": "Response when updating a secret"
54732
- }
54733
- },
54734
- "x-github": {
54735
- "githubCloudOnly": false,
54736
- "enabledForGitHubApps": true,
54737
- "category": "actions",
54738
- "subcategory": "secrets"
54739
- },
54740
- "x-octokit": {}
54741
- },
54742
- "delete": {
54743
- "summary": "Delete an environment secret",
54744
- "description": "Deletes a secret in an environment using the secret name.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read secrets.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54745
- "tags": [
54746
- "actions"
54747
- ],
54748
- "operationId": "actions/delete-environment-secret",
54749
- "externalDocs": {
54750
- "description": "API method documentation",
54751
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/secrets#delete-an-environment-secret"
54752
- },
54753
- "parameters": [
54754
- {
54755
- "$ref": "#/components/parameters/repository-id"
54756
- },
54757
- {
54758
- "$ref": "#/components/parameters/environment-name"
54759
- },
54760
- {
54761
- "$ref": "#/components/parameters/secret-name"
54762
- }
54763
- ],
54764
- "responses": {
54765
- "204": {
54766
- "description": "Default response"
54767
- }
54768
- },
54769
- "x-github": {
54770
- "githubCloudOnly": false,
54771
- "enabledForGitHubApps": true,
54772
- "category": "actions",
54773
- "subcategory": "secrets"
54774
- },
54775
- "x-octokit": {}
54776
- }
54777
- },
54778
- "/repositories/{repository_id}/environments/{environment_name}/variables": {
54779
- "get": {
54780
- "summary": "List environment variables",
54781
- "description": "Lists all environment variables.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54782
- "tags": [
54783
- "actions"
54784
- ],
54785
- "operationId": "actions/list-environment-variables",
54786
- "externalDocs": {
54787
- "description": "API method documentation",
54788
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#list-environment-variables"
54789
- },
54790
- "parameters": [
54791
- {
54792
- "$ref": "#/components/parameters/repository-id"
54793
- },
54794
- {
54795
- "$ref": "#/components/parameters/environment-name"
54796
- },
54797
- {
54798
- "$ref": "#/components/parameters/variables-per-page"
54799
- },
54800
- {
54801
- "$ref": "#/components/parameters/page"
54802
- }
54803
- ],
54804
- "responses": {
54805
- "200": {
54806
- "description": "Response",
54807
- "content": {
54808
- "application/json": {
54809
- "schema": {
54810
- "type": "object",
54811
- "required": [
54812
- "total_count",
54813
- "variables"
54814
- ],
54815
- "properties": {
54816
- "total_count": {
54817
- "type": "integer"
54818
- },
54819
- "variables": {
54820
- "type": "array",
54821
- "items": {
54822
- "$ref": "#/components/schemas/actions-variable"
54823
- }
54824
- }
54825
- }
54826
- },
54827
- "examples": {
54828
- "default": {
54829
- "$ref": "#/components/examples/actions-variables-paginated"
54830
- }
54831
- }
54832
- }
54833
- },
54834
- "headers": {
54835
- "Link": {
54836
- "$ref": "#/components/headers/link"
54837
- }
54838
- }
54839
- }
54840
- },
54841
- "x-github": {
54842
- "githubCloudOnly": false,
54843
- "enabledForGitHubApps": true,
54844
- "category": "actions",
54845
- "subcategory": "variables"
54846
- },
54847
- "x-octokit": {}
54848
- },
54849
- "post": {
54850
- "summary": "Create an environment variable",
54851
- "description": "Create an environment variable that you can reference in a GitHub Actions workflow.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54852
- "tags": [
54853
- "actions"
54854
- ],
54855
- "operationId": "actions/create-environment-variable",
54856
- "externalDocs": {
54857
- "description": "API method documentation",
54858
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#create-an-environment-variable"
54859
- },
54860
- "parameters": [
54861
- {
54862
- "$ref": "#/components/parameters/repository-id"
54863
- },
54864
- {
54865
- "$ref": "#/components/parameters/environment-name"
54866
- }
54867
- ],
54868
- "requestBody": {
54869
- "required": true,
54870
- "content": {
54871
- "application/json": {
54872
- "schema": {
54873
- "type": "object",
54874
- "properties": {
54875
- "name": {
54876
- "type": "string",
54877
- "description": "The name of the variable."
54878
- },
54879
- "value": {
54880
- "type": "string",
54881
- "description": "The value of the variable."
54882
- }
54883
- },
54884
- "required": [
54885
- "name",
54886
- "value"
54887
- ]
54888
- },
54889
- "examples": {
54890
- "default": {
54891
- "value": {
54892
- "name": "USERNAME",
54893
- "value": "octocat"
54894
- }
54895
- }
54896
- }
54897
- }
54898
- }
54899
- },
54900
- "responses": {
54901
- "201": {
54902
- "description": "Response",
54903
- "content": {
54904
- "application/json": {
54905
- "schema": {
54906
- "$ref": "#/components/schemas/empty-object"
54907
- },
54908
- "examples": {
54909
- "default": {
54910
- "value": null
54911
- }
54912
- }
54913
- }
54914
- }
54915
- }
54916
- },
54917
- "x-github": {
54918
- "githubCloudOnly": false,
54919
- "enabledForGitHubApps": true,
54920
- "category": "actions",
54921
- "subcategory": "variables"
54922
- },
54923
- "x-octokit": {}
54924
- }
54925
- },
54926
- "/repositories/{repository_id}/environments/{environment_name}/variables/{name}": {
54927
- "get": {
54928
- "summary": "Get an environment variable",
54929
- "description": "Gets a specific variable in an environment.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54930
- "tags": [
54931
- "actions"
54932
- ],
54933
- "operationId": "actions/get-environment-variable",
54934
- "externalDocs": {
54935
- "description": "API method documentation",
54936
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#get-an-environment-variable"
54937
- },
54938
- "parameters": [
54939
- {
54940
- "$ref": "#/components/parameters/repository-id"
54941
- },
54942
- {
54943
- "$ref": "#/components/parameters/environment-name"
54944
- },
54945
- {
54946
- "$ref": "#/components/parameters/variable-name"
54947
- }
54948
- ],
54949
- "responses": {
54950
- "200": {
54951
- "description": "Response",
54952
- "content": {
54953
- "application/json": {
54954
- "schema": {
54955
- "$ref": "#/components/schemas/actions-variable"
54956
- },
54957
- "examples": {
54958
- "default": {
54959
- "$ref": "#/components/examples/actions-variable"
54960
- }
54961
- }
54962
- }
54963
- }
54964
- }
54965
- },
54966
- "x-github": {
54967
- "githubCloudOnly": false,
54968
- "enabledForGitHubApps": true,
54969
- "category": "actions",
54970
- "subcategory": "variables"
54971
- },
54972
- "x-octokit": {}
54973
- },
54974
- "patch": {
54975
- "summary": "Update an environment variable",
54976
- "description": "Updates an environment variable that you can reference in a GitHub Actions workflow.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
54977
- "tags": [
54978
- "actions"
54979
- ],
54980
- "operationId": "actions/update-environment-variable",
54981
- "externalDocs": {
54982
- "description": "API method documentation",
54983
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#update-an-environment-variable"
54984
- },
54985
- "parameters": [
54986
- {
54987
- "$ref": "#/components/parameters/repository-id"
54988
- },
54989
- {
54990
- "$ref": "#/components/parameters/variable-name"
54991
- },
54992
- {
54993
- "$ref": "#/components/parameters/environment-name"
54994
- }
54995
- ],
54996
- "requestBody": {
54997
- "required": true,
54998
- "content": {
54999
- "application/json": {
55000
- "schema": {
55001
- "type": "object",
55002
- "properties": {
55003
- "name": {
55004
- "type": "string",
55005
- "description": "The name of the variable."
55006
- },
55007
- "value": {
55008
- "type": "string",
55009
- "description": "The value of the variable."
55010
- }
55011
- }
55012
- },
55013
- "examples": {
55014
- "default": {
55015
- "value": {
55016
- "name": "USERNAME",
55017
- "value": "octocat"
55018
- }
55019
- }
55020
- }
55021
- }
55022
- }
55023
- },
55024
- "responses": {
55025
- "204": {
55026
- "description": "Response"
55027
- }
55028
- },
55029
- "x-github": {
55030
- "githubCloudOnly": false,
55031
- "enabledForGitHubApps": true,
55032
- "category": "actions",
55033
- "subcategory": "variables"
55034
- },
55035
- "x-octokit": {}
55036
- },
55037
- "delete": {
55038
- "summary": "Delete an environment variable",
55039
- "description": "Deletes an environment variable using the variable name.\n\nAuthenticated users must have collaborator access to a repository to create, update, or read variables.\n\nOAuth tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
55040
- "tags": [
55041
- "actions"
55042
- ],
55043
- "operationId": "actions/delete-environment-variable",
55044
- "externalDocs": {
55045
- "description": "API method documentation",
55046
- "url": "https://docs.github.com/enterprise-server@3.12/rest/actions/variables#delete-an-environment-variable"
55047
- },
55048
- "parameters": [
55049
- {
55050
- "$ref": "#/components/parameters/repository-id"
55051
- },
55052
- {
55053
- "$ref": "#/components/parameters/variable-name"
55054
- },
55055
- {
55056
- "$ref": "#/components/parameters/environment-name"
55057
- }
55058
- ],
55059
- "responses": {
55060
- "204": {
55061
- "description": "Response"
55062
- }
55063
- },
55064
- "x-github": {
55065
- "githubCloudOnly": false,
55066
- "enabledForGitHubApps": true,
55067
- "category": "actions",
55068
- "subcategory": "variables"
55069
- },
55070
- "x-octokit": {}
55071
- }
55072
- },
55073
- "/scim/v2/Groups": {
55143
+ "/scim/v2/enterprises/{enterprise}/Groups": {
55074
55144
  "get": {
55075
55145
  "summary": "List provisioned SCIM groups for an enterprise",
55076
55146
  "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.\n\nLists provisioned SCIM groups in an enterprise.\n\nYou can improve query search time by using the `excludedAttributes` query parameter with a value of `members` to exclude members from the response.",
@@ -55109,6 +55179,9 @@
55109
55179
  },
55110
55180
  {
55111
55181
  "$ref": "#/components/parameters/count"
55182
+ },
55183
+ {
55184
+ "$ref": "#/components/parameters/enterprise"
55112
55185
  }
55113
55186
  ],
55114
55187
  "responses": {
@@ -55162,6 +55235,11 @@
55162
55235
  "description": "API method documentation",
55163
55236
  "url": "https://docs.github.com/enterprise-server@3.12/rest/enterprise-admin/scim#provision-a-scim-enterprise-group"
55164
55237
  },
55238
+ "parameters": [
55239
+ {
55240
+ "$ref": "#/components/parameters/enterprise"
55241
+ }
55242
+ ],
55165
55243
  "requestBody": {
55166
55244
  "required": true,
55167
55245
  "content": {
@@ -55227,7 +55305,7 @@
55227
55305
  "x-octokit": {}
55228
55306
  }
55229
55307
  },
55230
- "/scim/v2/Groups/{scim_group_id}": {
55308
+ "/scim/v2/enterprises/{enterprise}/Groups/{scim_group_id}": {
55231
55309
  "get": {
55232
55310
  "summary": "Get SCIM provisioning information for an enterprise group",
55233
55311
  "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.\n\nGets information about a SCIM group.",
@@ -55245,6 +55323,9 @@
55245
55323
  },
55246
55324
  {
55247
55325
  "$ref": "#/components/parameters/excluded-attributes"
55326
+ },
55327
+ {
55328
+ "$ref": "#/components/parameters/enterprise"
55248
55329
  }
55249
55330
  ],
55250
55331
  "responses": {
@@ -55304,6 +55385,9 @@
55304
55385
  "parameters": [
55305
55386
  {
55306
55387
  "$ref": "#/components/parameters/scim-group-id"
55388
+ },
55389
+ {
55390
+ "$ref": "#/components/parameters/enterprise"
55307
55391
  }
55308
55392
  ],
55309
55393
  "requestBody": {
@@ -55411,6 +55495,9 @@
55411
55495
  "parameters": [
55412
55496
  {
55413
55497
  "$ref": "#/components/parameters/scim-group-id"
55498
+ },
55499
+ {
55500
+ "$ref": "#/components/parameters/enterprise"
55414
55501
  }
55415
55502
  ],
55416
55503
  "requestBody": {
@@ -55528,6 +55615,9 @@
55528
55615
  "parameters": [
55529
55616
  {
55530
55617
  "$ref": "#/components/parameters/scim-group-id"
55618
+ },
55619
+ {
55620
+ "$ref": "#/components/parameters/enterprise"
55531
55621
  }
55532
55622
  ],
55533
55623
  "responses": {
@@ -55562,7 +55652,7 @@
55562
55652
  "x-octokit": {}
55563
55653
  }
55564
55654
  },
55565
- "/scim/v2/Users": {
55655
+ "/scim/v2/enterprises/{enterprise}/Users": {
55566
55656
  "get": {
55567
55657
  "summary": "List SCIM provisioned identities for an enterprise",
55568
55658
  "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.\n\nLists provisioned SCIM enterprise members.\n\nWhen a user with a SCIM-provisioned external identity is removed from an enterprise through a `patch` with `active` flag set to `false`, the account's metadata is preserved to allow the user to re-join the enterprise in the future. However, the user's account will be suspended and the user will not be able to sign-in. In order to permanently suspend the users account with no ability to re-join the enterprise in the future, use the `delete` request. Users that were not permanently deleted will be visible in the returned results.",
@@ -55597,6 +55687,9 @@
55597
55687
  },
55598
55688
  {
55599
55689
  "$ref": "#/components/parameters/count"
55690
+ },
55691
+ {
55692
+ "$ref": "#/components/parameters/enterprise"
55600
55693
  }
55601
55694
  ],
55602
55695
  "responses": {
@@ -55650,6 +55743,11 @@
55650
55743
  "description": "API method documentation",
55651
55744
  "url": "https://docs.github.com/enterprise-server@3.12/rest/enterprise-admin/scim#provision-a-scim-enterprise-user"
55652
55745
  },
55746
+ "parameters": [
55747
+ {
55748
+ "$ref": "#/components/parameters/enterprise"
55749
+ }
55750
+ ],
55653
55751
  "requestBody": {
55654
55752
  "required": true,
55655
55753
  "content": {
@@ -55715,7 +55813,7 @@
55715
55813
  "x-octokit": {}
55716
55814
  }
55717
55815
  },
55718
- "/scim/v2/Users/{scim_user_id}": {
55816
+ "/scim/v2/enterprises/{enterprise}/Users/{scim_user_id}": {
55719
55817
  "get": {
55720
55818
  "summary": "Get SCIM provisioning information for an enterprise user",
55721
55819
  "description": "**Note:** The SCIM API endpoints for enterprise accounts are currently in *private* beta and are subject to change.\n\nGets information about a SCIM user.",
@@ -55730,6 +55828,9 @@
55730
55828
  "parameters": [
55731
55829
  {
55732
55830
  "$ref": "#/components/parameters/scim-user-id"
55831
+ },
55832
+ {
55833
+ "$ref": "#/components/parameters/enterprise"
55733
55834
  }
55734
55835
  ],
55735
55836
  "responses": {
@@ -55789,6 +55890,9 @@
55789
55890
  "parameters": [
55790
55891
  {
55791
55892
  "$ref": "#/components/parameters/scim-user-id"
55893
+ },
55894
+ {
55895
+ "$ref": "#/components/parameters/enterprise"
55792
55896
  }
55793
55897
  ],
55794
55898
  "requestBody": {
@@ -55866,6 +55970,9 @@
55866
55970
  "parameters": [
55867
55971
  {
55868
55972
  "$ref": "#/components/parameters/scim-user-id"
55973
+ },
55974
+ {
55975
+ "$ref": "#/components/parameters/enterprise"
55869
55976
  }
55870
55977
  ],
55871
55978
  "requestBody": {
@@ -56001,6 +56108,9 @@
56001
56108
  "parameters": [
56002
56109
  {
56003
56110
  "$ref": "#/components/parameters/scim-user-id"
56111
+ },
56112
+ {
56113
+ "$ref": "#/components/parameters/enterprise"
56004
56114
  }
56005
56115
  ],
56006
56116
  "responses": {
@@ -64443,7 +64553,7 @@
64443
64553
  "/users/{username}/hovercard": {
64444
64554
  "get": {
64445
64555
  "summary": "Get contextual information for a user",
64446
- "description": "Provides hovercard information. You can find out more about someone in relation to their pull requests, issues, repositories, and organizations.\n\nThe `subject_type` and `subject_id` parameters provide context for the person's hovercard, which returns more information than without the parameters. For example, if you wanted to find out more about `octocat` who owns the `Spoon-Knife` repository via cURL, it would look like this:\n\n```shell\n curl -u username:token\n https://api.github.com/users/octocat/hovercard?subject_type=repository&subject_id=1300192\n```\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
64556
+ "description": "Provides hovercard information. You can find out more about someone in relation to their pull requests, issues, repositories, and organizations.\n\n The `subject_type` and `subject_id` parameters provide context for the person's hovercard, which returns more information than without the parameters. For example, if you wanted to find out more about `octocat` who owns the `Spoon-Knife` repository, you would use a `subject_type` value of `repository` and a `subject_id` value of `1300192` (the ID of the `Spoon-Knife` repository).\n\nOAuth app tokens and personal access tokens (classic) need the `repo` scope to use this endpoint.",
64447
64557
  "tags": [
64448
64558
  "users"
64449
64559
  ],
@@ -103992,6 +104102,38 @@
103992
104102
  }
103993
104103
  }
103994
104104
  },
104105
+ "repository-rule-params-thresholds": {
104106
+ "title": "Thresholds",
104107
+ "description": "This setting will not take effect unless at least one code scanning status check is enabled.",
104108
+ "type": "object",
104109
+ "properties": {
104110
+ "code_scanning_alert_threshold": {
104111
+ "type": "string",
104112
+ "description": "Code scanning alert threshold",
104113
+ "enum": [
104114
+ "none",
104115
+ "errors",
104116
+ "errors_and_warnings",
104117
+ "all"
104118
+ ]
104119
+ },
104120
+ "code_scanning_security_alert_threshold": {
104121
+ "type": "string",
104122
+ "description": "Code scanning security alert threshold.",
104123
+ "enum": [
104124
+ "none",
104125
+ "critical",
104126
+ "high_or_higher",
104127
+ "medium_or_higher",
104128
+ "all"
104129
+ ]
104130
+ }
104131
+ },
104132
+ "required": [
104133
+ "code_scanning_alert_threshold",
104134
+ "code_scanning_security_alert_threshold"
104135
+ ]
104136
+ },
103995
104137
  "repository-rule": {
103996
104138
  "title": "Repository Rule",
103997
104139
  "type": "object",
@@ -106277,7 +106419,9 @@
106277
106419
  "queued",
106278
106420
  "in_progress",
106279
106421
  "completed",
106280
- "waiting"
106422
+ "waiting",
106423
+ "requested",
106424
+ "pending"
106281
106425
  ]
106282
106426
  },
106283
106427
  "conclusion": {
@@ -108810,13 +108954,16 @@
108810
108954
  "nullable": true
108811
108955
  },
108812
108956
  "status": {
108813
- "description": "The phase of the lifecycle that the check is currently in.",
108957
+ "description": "The phase of the lifecycle that the check is currently in. Statuses of waiting, requested, and pending are reserved for GitHub Actions check runs.",
108814
108958
  "example": "queued",
108815
108959
  "type": "string",
108816
108960
  "enum": [
108817
108961
  "queued",
108818
108962
  "in_progress",
108819
- "completed"
108963
+ "completed",
108964
+ "waiting",
108965
+ "requested",
108966
+ "pending"
108820
108967
  ]
108821
108968
  },
108822
108969
  "conclusion": {
@@ -109094,11 +109241,15 @@
109094
109241
  },
109095
109242
  "status": {
109096
109243
  "type": "string",
109244
+ "description": "The phase of the lifecycle that the check suite is currently in. Statuses of waiting, requested, and pending are reserved for GitHub Actions check suites.",
109097
109245
  "example": "completed",
109098
109246
  "enum": [
109099
109247
  "queued",
109100
109248
  "in_progress",
109101
- "completed"
109249
+ "completed",
109250
+ "waiting",
109251
+ "requested",
109252
+ "pending"
109102
109253
  ],
109103
109254
  "nullable": true
109104
109255
  },
@@ -173448,6 +173599,7 @@
173448
173599
  "type": "object",
173449
173600
  "properties": {
173450
173601
  "permission": {
173602
+ "description": "This field is included for legacy purposes; use the `role_name` field instead. The `maintain`\nrole is mapped to `write` and the `triage` role is mapped to `read`. To determine the role\nassigned to the collaborator, use the `role_name` field instead, which will provide the full\nrole name, including custom roles.",
173451
173603
  "type": "object",
173452
173604
  "properties": {
173453
173605
  "to": {
@@ -173462,6 +173614,18 @@
173462
173614
  "required": [
173463
173615
  "to"
173464
173616
  ]
173617
+ },
173618
+ "role_name": {
173619
+ "description": "The role assigned to the collaborator.",
173620
+ "type": "object",
173621
+ "properties": {
173622
+ "to": {
173623
+ "type": "string"
173624
+ }
173625
+ },
173626
+ "required": [
173627
+ "to"
173628
+ ]
173465
173629
  }
173466
173630
  }
173467
173631
  },
@@ -252008,7 +252172,7 @@
252008
252172
  "type": "string"
252009
252173
  },
252010
252174
  "commits": {
252011
- "description": "An array of commit objects describing the pushed commits. (Pushed commits are all commits that are included in the `compare` between the `before` commit and the `after` commit.) The array includes a maximum of 20 commits. If necessary, you can use the [Commits API](https://docs.github.com/enterprise-server@3.12/rest/commits) to fetch additional commits. This limit is applied to timeline events only and isn't applied to webhook deliveries.",
252175
+ "description": "An array of commit objects describing the pushed commits. (Pushed commits are all commits that are included in the `compare` between the `before` commit and the `after` commit.) The array includes a maximum of 2048 commits. If necessary, you can use the [Commits API](https://docs.github.com/enterprise-server@3.12/rest/commits) to fetch additional commits.",
252012
252176
  "type": "array",
252013
252177
  "items": {
252014
252178
  "title": "Commit",
@@ -302251,7 +302415,7 @@
302251
302415
  },
302252
302416
  "workflow-run-status": {
302253
302417
  "name": "status",
302254
- "description": "Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status can be `in_progress`. Only GitHub can set a status of `waiting` or `requested`.",
302418
+ "description": "Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status can be `in_progress`. Only GitHub Actions can set a status of `waiting`, `pending`, or `requested`.",
302255
302419
  "in": "query",
302256
302420
  "required": false,
302257
302421
  "schema": {
@@ -302505,6 +302669,17 @@
302505
302669
  "type": "integer"
302506
302670
  }
302507
302671
  },
302672
+ "git-ref-only": {
302673
+ "name": "ref",
302674
+ "description": "The Git reference. For more information, see \"[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)\" in the Git documentation.",
302675
+ "in": "path",
302676
+ "required": true,
302677
+ "example": "heads/feature-a",
302678
+ "schema": {
302679
+ "type": "string"
302680
+ },
302681
+ "x-multi-segment": true
302682
+ },
302508
302683
  "invitation-id": {
302509
302684
  "name": "invitation_id",
302510
302685
  "description": "The unique identifier of the invitation.",