@octokit/openapi 6.4.0 → 6.5.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": "6.4.0",
4
+ "version": "6.5.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -4802,6 +4802,58 @@
4802
4802
  }
4803
4803
  }
4804
4804
  },
4805
+ "/rate_limit": {
4806
+ "get": {
4807
+ "summary": "Get rate limit status for the authenticated user",
4808
+ "description": "**Note:** Accessing this endpoint does not count against your REST API rate limit.\n\n**Note:** The `rate` object is deprecated. If you're writing new API client code or updating existing code, you should use the `core` object instead of the `rate` object. The `core` object contains the same information that is present in the `rate` object.",
4809
+ "tags": ["rate-limit"],
4810
+ "operationId": "rate-limit/get",
4811
+ "externalDocs": {
4812
+ "description": "API method documentation",
4813
+ "url": "https://docs.github.com/enterprise-server@3.5/rest/reference/rate-limit#get-rate-limit-status-for-the-authenticated-user"
4814
+ },
4815
+ "parameters": [],
4816
+ "responses": {
4817
+ "200": {
4818
+ "description": "Response",
4819
+ "content": {
4820
+ "application/json": {
4821
+ "schema": {
4822
+ "$ref": "#/components/schemas/rate-limit-overview"
4823
+ },
4824
+ "examples": {
4825
+ "default": {
4826
+ "$ref": "#/components/examples/rate-limit-overview"
4827
+ }
4828
+ }
4829
+ }
4830
+ },
4831
+ "headers": {
4832
+ "X-RateLimit-Limit": {
4833
+ "$ref": "#/components/headers/x-rate-limit-limit"
4834
+ },
4835
+ "X-RateLimit-Remaining": {
4836
+ "$ref": "#/components/headers/x-rate-limit-remaining"
4837
+ },
4838
+ "X-RateLimit-Reset": {
4839
+ "$ref": "#/components/headers/x-rate-limit-reset"
4840
+ }
4841
+ }
4842
+ },
4843
+ "304": { "$ref": "#/components/responses/not_modified" },
4844
+ "404": { "$ref": "#/components/responses/not_found" }
4845
+ },
4846
+ "x-github": {
4847
+ "githubCloudOnly": false,
4848
+ "enabledForGitHubApps": true,
4849
+ "category": "rate-limit",
4850
+ "subcategory": null
4851
+ },
4852
+ "x-octokit": {
4853
+ "diff": { "api.github.com.json": { "type": "changed" } }
4854
+ }
4855
+ }
4856
+ },
4805
4857
  "/repos/{owner}/{repo}": {
4806
4858
  "get": {
4807
4859
  "summary": "Get a repository",
@@ -14632,6 +14684,35 @@
14632
14684
  "updated_at"
14633
14685
  ]
14634
14686
  },
14687
+ "rate-limit-overview": {
14688
+ "title": "Rate Limit Overview",
14689
+ "description": "Rate Limit Overview",
14690
+ "type": "object",
14691
+ "properties": {
14692
+ "resources": {
14693
+ "type": "object",
14694
+ "properties": {
14695
+ "core": { "$ref": "#/components/schemas/rate-limit" },
14696
+ "graphql": { "$ref": "#/components/schemas/rate-limit" },
14697
+ "search": { "$ref": "#/components/schemas/rate-limit" },
14698
+ "source_import": { "$ref": "#/components/schemas/rate-limit" },
14699
+ "integration_manifest": {
14700
+ "$ref": "#/components/schemas/rate-limit"
14701
+ },
14702
+ "code_scanning_upload": {
14703
+ "$ref": "#/components/schemas/rate-limit"
14704
+ },
14705
+ "actions_runner_registration": {
14706
+ "$ref": "#/components/schemas/rate-limit"
14707
+ },
14708
+ "scim": { "$ref": "#/components/schemas/rate-limit" }
14709
+ },
14710
+ "required": ["core", "search"]
14711
+ },
14712
+ "rate": { "$ref": "#/components/schemas/rate-limit" }
14713
+ },
14714
+ "required": ["rate", "resources"]
14715
+ },
14635
14716
  "full-repository": {
14636
14717
  "title": "Full Repository",
14637
14718
  "description": "Full Repository",
@@ -18241,6 +18322,17 @@
18241
18322
  ],
18242
18323
  "nullable": true
18243
18324
  },
18325
+ "rate-limit": {
18326
+ "title": "Rate Limit",
18327
+ "type": "object",
18328
+ "properties": {
18329
+ "limit": { "type": "integer" },
18330
+ "remaining": { "type": "integer" },
18331
+ "reset": { "type": "integer" },
18332
+ "used": { "type": "integer" }
18333
+ },
18334
+ "required": ["limit", "remaining", "reset", "used"]
18335
+ },
18244
18336
  "code-of-conduct-simple": {
18245
18337
  "title": "Code Of Conduct Simple",
18246
18338
  "description": "Code of Conduct Simple",
@@ -22436,6 +22528,48 @@
22436
22528
  "watchers": 1
22437
22529
  }
22438
22530
  },
22531
+ "rate-limit-overview": {
22532
+ "value": {
22533
+ "resources": {
22534
+ "core": {
22535
+ "limit": 5000,
22536
+ "remaining": 4999,
22537
+ "reset": 1372700873,
22538
+ "used": 1
22539
+ },
22540
+ "search": {
22541
+ "limit": 30,
22542
+ "remaining": 18,
22543
+ "reset": 1372697452,
22544
+ "used": 12
22545
+ },
22546
+ "graphql": {
22547
+ "limit": 5000,
22548
+ "remaining": 4993,
22549
+ "reset": 1372700389,
22550
+ "used": 7
22551
+ },
22552
+ "integration_manifest": {
22553
+ "limit": 5000,
22554
+ "remaining": 4999,
22555
+ "reset": 1551806725,
22556
+ "used": 1
22557
+ },
22558
+ "code_scanning_upload": {
22559
+ "limit": 500,
22560
+ "remaining": 499,
22561
+ "reset": 1551806725,
22562
+ "used": 1
22563
+ }
22564
+ },
22565
+ "rate": {
22566
+ "limit": 5000,
22567
+ "remaining": 4999,
22568
+ "reset": 1372700873,
22569
+ "used": 1
22570
+ }
22571
+ }
22572
+ },
22439
22573
  "full-repository-default-response": {
22440
22574
  "summary": "Default response",
22441
22575
  "value": {
@@ -29429,6 +29563,18 @@
29429
29563
  "link": {
29430
29564
  "example": "<https://api.github.com/resource?page=2>; rel=\"next\", <https://api.github.com/resource?page=5>; rel=\"last\"",
29431
29565
  "schema": { "type": "string" }
29566
+ },
29567
+ "x-rate-limit-limit": {
29568
+ "example": 5000,
29569
+ "schema": { "type": "integer" }
29570
+ },
29571
+ "x-rate-limit-remaining": {
29572
+ "example": 4999,
29573
+ "schema": { "type": "integer" }
29574
+ },
29575
+ "x-rate-limit-reset": {
29576
+ "example": 1590701888,
29577
+ "schema": { "type": "integer", "format": "timestamp" }
29432
29578
  }
29433
29579
  },
29434
29580
  "responses": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "6.4.0",
4
+ "version": "6.5.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -94387,7 +94387,7 @@
94387
94387
  "category": "rate-limit",
94388
94388
  "subcategory": null
94389
94389
  },
94390
- "x-octokit": {}
94390
+ "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
94391
94391
  }
94392
94392
  },
94393
94393
  "/repos/{owner}/{repo}": {
@@ -118623,7 +118623,7 @@
118623
118623
  },
118624
118624
  "post": {
118625
118625
  "summary": "Review pending deployments for a workflow run",
118626
- "description": "Approve or reject pending deployments that are waiting on approval by a required reviewer.\n\nAnyone with read access to the repository contents and deployments can use this endpoint.",
118626
+ "description": "Approve or reject pending deployments that are waiting on approval by a required reviewer.\n\nRequired reviewers with read access to the repository contents and deployments can use this endpoint. Required reviewers must authenticate using an access token with the `repo` scope to use this endpoint.",
118627
118627
  "tags": ["actions"],
118628
118628
  "operationId": "actions/review-pending-deployments-for-run",
118629
118629
  "externalDocs": {
@@ -119160,7 +119160,7 @@
119160
119160
  },
119161
119161
  "x-github": {
119162
119162
  "githubCloudOnly": false,
119163
- "enabledForGitHubApps": true,
119163
+ "enabledForGitHubApps": false,
119164
119164
  "category": "actions",
119165
119165
  "subcategory": "workflow-runs"
119166
119166
  },
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "6.4.0",
4
+ "version": "6.5.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -14989,7 +14989,9 @@
14989
14989
  "category": "rate-limit",
14990
14990
  "subcategory": null
14991
14991
  },
14992
- "x-octokit": {}
14992
+ "x-octokit": {
14993
+ "diff": { "api.github.com.json": { "type": "changed" } }
14994
+ }
14993
14995
  }
14994
14996
  },
14995
14997
  "/repos/{owner}/{repo}": {
@@ -16884,7 +16886,7 @@
16884
16886
  },
16885
16887
  "post": {
16886
16888
  "summary": "Review pending deployments for a workflow run",
16887
- "description": "Approve or reject pending deployments that are waiting on approval by a required reviewer.\n\nAnyone with read access to the repository contents and deployments can use this endpoint.",
16889
+ "description": "Approve or reject pending deployments that are waiting on approval by a required reviewer.\n\nRequired reviewers with read access to the repository contents and deployments can use this endpoint. Required reviewers must authenticate using an access token with the `repo` scope to use this endpoint.",
16888
16890
  "tags": ["actions"],
16889
16891
  "operationId": "actions/review-pending-deployments-for-run",
16890
16892
  "externalDocs": {
@@ -16946,7 +16948,7 @@
16946
16948
  },
16947
16949
  "x-github": {
16948
16950
  "githubCloudOnly": false,
16949
- "enabledForGitHubApps": true,
16951
+ "enabledForGitHubApps": false,
16950
16952
  "category": "actions",
16951
16953
  "subcategory": "workflow-runs"
16952
16954
  },
@@ -5924,6 +5924,33 @@
5924
5924
  }
5925
5925
  }
5926
5926
  },
5927
+ "/rate_limit": {
5928
+ "get": {
5929
+ "responses": {
5930
+ "changed": {
5931
+ "200": {
5932
+ "content": {
5933
+ "changed": {
5934
+ "application/json": {
5935
+ "schema_changed": {
5936
+ "properties_changed": {
5937
+ "changed": {
5938
+ "resources": {
5939
+ "properties_changed": {
5940
+ "removed": ["dependency_snapshots"]
5941
+ }
5942
+ }
5943
+ }
5944
+ }
5945
+ }
5946
+ }
5947
+ }
5948
+ }
5949
+ }
5950
+ }
5951
+ }
5952
+ }
5953
+ },
5927
5954
  "/repos/{owner}/{repo}": {
5928
5955
  "get": {
5929
5956
  "responses": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "6.4.0",
4
+ "version": "6.5.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": { "name": "MIT", "url": "https://spdx.org/licenses/MIT" },
@@ -32191,6 +32191,225 @@
32191
32191
  "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
32192
32192
  }
32193
32193
  },
32194
+ "/rate_limit": {
32195
+ "get": {
32196
+ "summary": "Get rate limit status for the authenticated user",
32197
+ "description": "**Note:** Accessing this endpoint does not count against your REST API rate limit.\n\n**Note:** The `rate` object is deprecated. If you're writing new API client code or updating existing code, you should use the `core` object instead of the `rate` object. The `core` object contains the same information that is present in the `rate` object.",
32198
+ "tags": ["rate-limit"],
32199
+ "operationId": "rate-limit/get",
32200
+ "externalDocs": {
32201
+ "description": "API method documentation",
32202
+ "url": "https://docs.github.com/github-ae@latest/rest/reference/rate-limit#get-rate-limit-status-for-the-authenticated-user"
32203
+ },
32204
+ "parameters": [],
32205
+ "responses": {
32206
+ "200": {
32207
+ "description": "Response",
32208
+ "content": {
32209
+ "application/json": {
32210
+ "schema": {
32211
+ "title": "Rate Limit Overview",
32212
+ "description": "Rate Limit Overview",
32213
+ "type": "object",
32214
+ "properties": {
32215
+ "resources": {
32216
+ "type": "object",
32217
+ "properties": {
32218
+ "core": {
32219
+ "title": "Rate Limit",
32220
+ "type": "object",
32221
+ "properties": {
32222
+ "limit": { "type": "integer" },
32223
+ "remaining": { "type": "integer" },
32224
+ "reset": { "type": "integer" },
32225
+ "used": { "type": "integer" }
32226
+ },
32227
+ "required": ["limit", "remaining", "reset", "used"]
32228
+ },
32229
+ "graphql": {
32230
+ "title": "Rate Limit",
32231
+ "type": "object",
32232
+ "properties": {
32233
+ "limit": { "type": "integer" },
32234
+ "remaining": { "type": "integer" },
32235
+ "reset": { "type": "integer" },
32236
+ "used": { "type": "integer" }
32237
+ },
32238
+ "required": ["limit", "remaining", "reset", "used"]
32239
+ },
32240
+ "search": {
32241
+ "title": "Rate Limit",
32242
+ "type": "object",
32243
+ "properties": {
32244
+ "limit": { "type": "integer" },
32245
+ "remaining": { "type": "integer" },
32246
+ "reset": { "type": "integer" },
32247
+ "used": { "type": "integer" }
32248
+ },
32249
+ "required": ["limit", "remaining", "reset", "used"]
32250
+ },
32251
+ "source_import": {
32252
+ "title": "Rate Limit",
32253
+ "type": "object",
32254
+ "properties": {
32255
+ "limit": { "type": "integer" },
32256
+ "remaining": { "type": "integer" },
32257
+ "reset": { "type": "integer" },
32258
+ "used": { "type": "integer" }
32259
+ },
32260
+ "required": ["limit", "remaining", "reset", "used"]
32261
+ },
32262
+ "integration_manifest": {
32263
+ "title": "Rate Limit",
32264
+ "type": "object",
32265
+ "properties": {
32266
+ "limit": { "type": "integer" },
32267
+ "remaining": { "type": "integer" },
32268
+ "reset": { "type": "integer" },
32269
+ "used": { "type": "integer" }
32270
+ },
32271
+ "required": ["limit", "remaining", "reset", "used"]
32272
+ },
32273
+ "code_scanning_upload": {
32274
+ "title": "Rate Limit",
32275
+ "type": "object",
32276
+ "properties": {
32277
+ "limit": { "type": "integer" },
32278
+ "remaining": { "type": "integer" },
32279
+ "reset": { "type": "integer" },
32280
+ "used": { "type": "integer" }
32281
+ },
32282
+ "required": ["limit", "remaining", "reset", "used"]
32283
+ },
32284
+ "actions_runner_registration": {
32285
+ "title": "Rate Limit",
32286
+ "type": "object",
32287
+ "properties": {
32288
+ "limit": { "type": "integer" },
32289
+ "remaining": { "type": "integer" },
32290
+ "reset": { "type": "integer" },
32291
+ "used": { "type": "integer" }
32292
+ },
32293
+ "required": ["limit", "remaining", "reset", "used"]
32294
+ },
32295
+ "scim": {
32296
+ "title": "Rate Limit",
32297
+ "type": "object",
32298
+ "properties": {
32299
+ "limit": { "type": "integer" },
32300
+ "remaining": { "type": "integer" },
32301
+ "reset": { "type": "integer" },
32302
+ "used": { "type": "integer" }
32303
+ },
32304
+ "required": ["limit", "remaining", "reset", "used"]
32305
+ }
32306
+ },
32307
+ "required": ["core", "search"]
32308
+ },
32309
+ "rate": {
32310
+ "title": "Rate Limit",
32311
+ "type": "object",
32312
+ "properties": {
32313
+ "limit": { "type": "integer" },
32314
+ "remaining": { "type": "integer" },
32315
+ "reset": { "type": "integer" },
32316
+ "used": { "type": "integer" }
32317
+ },
32318
+ "required": ["limit", "remaining", "reset", "used"]
32319
+ }
32320
+ },
32321
+ "required": ["rate", "resources"]
32322
+ },
32323
+ "examples": {
32324
+ "default": {
32325
+ "value": {
32326
+ "resources": {
32327
+ "core": {
32328
+ "limit": 5000,
32329
+ "remaining": 4999,
32330
+ "reset": 1372700873,
32331
+ "used": 1
32332
+ },
32333
+ "search": {
32334
+ "limit": 30,
32335
+ "remaining": 18,
32336
+ "reset": 1372697452,
32337
+ "used": 12
32338
+ },
32339
+ "graphql": {
32340
+ "limit": 5000,
32341
+ "remaining": 4993,
32342
+ "reset": 1372700389,
32343
+ "used": 7
32344
+ },
32345
+ "integration_manifest": {
32346
+ "limit": 5000,
32347
+ "remaining": 4999,
32348
+ "reset": 1551806725,
32349
+ "used": 1
32350
+ },
32351
+ "code_scanning_upload": {
32352
+ "limit": 500,
32353
+ "remaining": 499,
32354
+ "reset": 1551806725,
32355
+ "used": 1
32356
+ }
32357
+ },
32358
+ "rate": {
32359
+ "limit": 5000,
32360
+ "remaining": 4999,
32361
+ "reset": 1372700873,
32362
+ "used": 1
32363
+ }
32364
+ }
32365
+ }
32366
+ }
32367
+ }
32368
+ },
32369
+ "headers": {
32370
+ "X-RateLimit-Limit": {
32371
+ "example": 5000,
32372
+ "schema": { "type": "integer" }
32373
+ },
32374
+ "X-RateLimit-Remaining": {
32375
+ "example": 4999,
32376
+ "schema": { "type": "integer" }
32377
+ },
32378
+ "X-RateLimit-Reset": {
32379
+ "example": 1590701888,
32380
+ "schema": { "type": "integer", "format": "timestamp" }
32381
+ }
32382
+ }
32383
+ },
32384
+ "304": { "description": "Not modified" },
32385
+ "404": {
32386
+ "description": "Resource not found",
32387
+ "content": {
32388
+ "application/json": {
32389
+ "schema": {
32390
+ "title": "Basic Error",
32391
+ "description": "Basic Error",
32392
+ "type": "object",
32393
+ "properties": {
32394
+ "message": { "type": "string" },
32395
+ "documentation_url": { "type": "string" },
32396
+ "url": { "type": "string" },
32397
+ "status": { "type": "string" }
32398
+ }
32399
+ }
32400
+ }
32401
+ }
32402
+ }
32403
+ },
32404
+ "x-github": {
32405
+ "githubCloudOnly": false,
32406
+ "enabledForGitHubApps": true,
32407
+ "category": "rate-limit",
32408
+ "subcategory": null
32409
+ },
32410
+ "x-octokit": { "diff": { "api.github.com": { "type": "changed" } } }
32411
+ }
32412
+ },
32194
32413
  "/repos/{owner}/{repo}": {
32195
32414
  "get": {
32196
32415
  "summary": "Get a repository",