@octokit/openapi 7.9.1 → 7.12.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.
Files changed (35) hide show
  1. package/generated/api.github.com.deref.json +2592 -690
  2. package/generated/api.github.com.json +567 -30
  3. package/generated/ghes-3.2-diff-to-api.github.com.deref.json +1 -1
  4. package/generated/ghes-3.2-diff-to-api.github.com.json +1 -1
  5. package/generated/ghes-3.2-diff-to-ghes-3.3.deref.json +8 -6
  6. package/generated/ghes-3.2-diff-to-ghes-3.3.json +8 -6
  7. package/generated/ghes-3.2.deref.json +763 -130
  8. package/generated/ghes-3.2.json +53 -10
  9. package/generated/ghes-3.3-anicca-diff-to-ghes-3.4.deref.json +21 -0
  10. package/generated/ghes-3.3-diff-to-ghes-3.4.deref.json +615 -1
  11. package/generated/ghes-3.3-diff-to-ghes-3.4.json +25 -1
  12. package/generated/ghes-3.3.deref.json +768 -135
  13. package/generated/ghes-3.3.json +53 -10
  14. package/generated/ghes-3.4-diff-to-ghes-3.5.deref.json +18 -2
  15. package/generated/ghes-3.4-diff-to-ghes-3.5.json +18 -2
  16. package/generated/ghes-3.4.deref.json +768 -130
  17. package/generated/ghes-3.4.json +55 -12
  18. package/generated/ghes-3.5-anicca-diff-to-ghes-3.6.deref.json +21 -0
  19. package/generated/ghes-3.5-diff-to-api.github.com.deref.json +1 -1
  20. package/generated/ghes-3.5-diff-to-api.github.com.json +1 -1
  21. package/generated/ghes-3.5-diff-to-ghes-3.6.deref.json +753 -132
  22. package/generated/ghes-3.5-diff-to-ghes-3.6.json +32 -6
  23. package/generated/ghes-3.5.deref.json +773 -135
  24. package/generated/ghes-3.5.json +55 -12
  25. package/generated/ghes-3.6-anicca-diff-to-api.github.com.deref.json +46 -0
  26. package/generated/ghes-3.6-diff-to-api.github.com.deref.json +141 -20
  27. package/generated/ghes-3.6-diff-to-api.github.com.json +126 -6
  28. package/generated/ghes-3.6.deref.json +1254 -421
  29. package/generated/ghes-3.6.json +160 -23
  30. package/generated/github.ae-anicca-diff-to-api.github.com.deref.json +10 -0
  31. package/generated/github.ae-diff-to-api.github.com.deref.json +24 -6
  32. package/generated/github.ae-diff-to-api.github.com.json +24 -6
  33. package/generated/github.ae.deref.json +1019 -290
  34. package/generated/github.ae.json +145 -16
  35. package/package.json +1 -6
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "openapi": "3.0.3",
3
3
  "info": {
4
- "version": "7.9.1",
4
+ "version": "7.12.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": {
@@ -5512,8 +5512,9 @@
5512
5512
  },
5513
5513
  "use_squash_pr_title_as_default": {
5514
5514
  "type": "boolean",
5515
- "description": "Whether a squash merge commit can use the pull request title as default.",
5516
- "default": false
5515
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
5516
+ "default": false,
5517
+ "deprecated": true
5517
5518
  },
5518
5519
  "squash_merge_commit_title": {
5519
5520
  "type": "string",
@@ -15947,8 +15948,9 @@
15947
15948
  },
15948
15949
  "use_squash_pr_title_as_default": {
15949
15950
  "type": "boolean",
15950
- "description": "Whether a squash merge commit can use the pull request title as default.",
15951
- "default": false
15951
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
15952
+ "default": false,
15953
+ "deprecated": true
15952
15954
  },
15953
15955
  "squash_merge_commit_title": {
15954
15956
  "type": "string",
@@ -17235,8 +17237,9 @@
17235
17237
  },
17236
17238
  "use_squash_pr_title_as_default": {
17237
17239
  "type": "boolean",
17238
- "description": "Whether a squash merge commit can use the pull request title as default.",
17239
- "default": false
17240
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
17241
+ "default": false,
17242
+ "deprecated": true
17240
17243
  },
17241
17244
  "squash_merge_commit_title": {
17242
17245
  "type": "string",
@@ -20126,7 +20129,7 @@
20126
20129
  "/enterprises/{enterprise}/consumed-licenses": {
20127
20130
  "get": {
20128
20131
  "summary": "List enterprise consumed licenses",
20129
- "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.",
20132
+ "description": "Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.\nTo use this endpoint, you must be an enterprise admin, and you must use an access\ntoken with the `read:enterprise` scope.\n\n**Note:** The license consumption API endpoints for enterprise accounts are currently\nin Beta and are subject to change.",
20130
20133
  "tags": [
20131
20134
  "enterprise-admin"
20132
20135
  ],
@@ -20206,7 +20209,15 @@
20206
20209
  },
20207
20210
  "github_com_enterprise_role": {
20208
20211
  "type": "string",
20209
- "nullable": true
20212
+ "nullable": true,
20213
+ "description": "Deprecated: The most permissive enterprise role for a user."
20214
+ },
20215
+ "github_com_enterprise_roles": {
20216
+ "type": "array",
20217
+ "description": "All enterprise roles for a user.",
20218
+ "items": {
20219
+ "type": "string"
20220
+ }
20210
20221
  },
20211
20222
  "visual_studio_subscription_user": {
20212
20223
  "type": "boolean"
@@ -20277,6 +20288,9 @@
20277
20288
  "org2:Owner"
20278
20289
  ],
20279
20290
  "github_com_enterprise_role": "owner",
20291
+ "github_com_enterprise_roles": [
20292
+ "owner"
20293
+ ],
20280
20294
  "visual_studio_subscription_user": false,
20281
20295
  "github_com_verified_domain_emails": [
20282
20296
  "monalisa@github.com"
@@ -20305,6 +20319,7 @@
20305
20319
  "license_type": "enterprise",
20306
20320
  "github_com_member_roles": [],
20307
20321
  "github_com_enterprise_role": "",
20322
+ "github_com_enterprise_roles": [],
20308
20323
  "visual_studio_subscription_user": false,
20309
20324
  "github_com_verified_domain_emails": [],
20310
20325
  "github_com_saml_name_id": "",
@@ -24122,8 +24137,9 @@
24122
24137
  },
24123
24138
  "use_squash_pr_title_as_default": {
24124
24139
  "type": "boolean",
24125
- "description": "Whether a squash merge commit can use the pull request title as default.",
24126
- "default": false
24140
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
24141
+ "default": false,
24142
+ "deprecated": true
24127
24143
  },
24128
24144
  "squash_merge_commit_title": {
24129
24145
  "type": "string",
@@ -36759,8 +36775,9 @@
36759
36775
  },
36760
36776
  "use_squash_pr_title_as_default": {
36761
36777
  "type": "boolean",
36762
- "description": "Whether a squash merge commit can use the pull request title as default.",
36763
- "default": false
36778
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
36779
+ "default": false,
36780
+ "deprecated": true
36764
36781
  },
36765
36782
  "squash_merge_commit_title": {
36766
36783
  "type": "string",
@@ -39233,8 +39250,9 @@
39233
39250
  },
39234
39251
  "use_squash_pr_title_as_default": {
39235
39252
  "type": "boolean",
39236
- "description": "Whether a squash merge commit can use the pull request title as default.",
39237
- "default": false
39253
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
39254
+ "default": false,
39255
+ "deprecated": true
39238
39256
  },
39239
39257
  "squash_merge_commit_title": {
39240
39258
  "type": "string",
@@ -45089,8 +45107,9 @@
45089
45107
  },
45090
45108
  "use_squash_pr_title_as_default": {
45091
45109
  "type": "boolean",
45092
- "description": "Whether a squash merge commit can use the pull request title as default.",
45093
- "default": false
45110
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
45111
+ "default": false,
45112
+ "deprecated": true
45094
45113
  },
45095
45114
  "squash_merge_commit_title": {
45096
45115
  "type": "string",
@@ -47842,8 +47861,9 @@
47842
47861
  },
47843
47862
  "use_squash_pr_title_as_default": {
47844
47863
  "type": "boolean",
47845
- "description": "Whether a squash merge commit can use the pull request title as default.",
47846
- "default": false
47864
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
47865
+ "default": false,
47866
+ "deprecated": true
47847
47867
  },
47848
47868
  "squash_merge_commit_title": {
47849
47869
  "type": "string",
@@ -50067,8 +50087,9 @@
50067
50087
  },
50068
50088
  "use_squash_pr_title_as_default": {
50069
50089
  "type": "boolean",
50070
- "description": "Whether a squash merge commit can use the pull request title as default.",
50071
- "default": false
50090
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
50091
+ "default": false,
50092
+ "deprecated": true
50072
50093
  },
50073
50094
  "squash_merge_commit_title": {
50074
50095
  "type": "string",
@@ -51308,6 +51329,155 @@
51308
51329
  "name": {
51309
51330
  "description": "The name of the custom role.",
51310
51331
  "type": "string"
51332
+ },
51333
+ "description": {
51334
+ "description": "A short description about who this role is for or what permissions it grants.",
51335
+ "type": "string",
51336
+ "nullable": true
51337
+ },
51338
+ "base_role": {
51339
+ "type": "string",
51340
+ "description": "The system role from which this role inherits permissions.",
51341
+ "enum": [
51342
+ "read",
51343
+ "triage",
51344
+ "write",
51345
+ "maintain"
51346
+ ]
51347
+ },
51348
+ "permissions": {
51349
+ "description": "A list of additional permissions included in this role.",
51350
+ "type": "array",
51351
+ "items": {
51352
+ "type": "string"
51353
+ }
51354
+ },
51355
+ "organization": {
51356
+ "title": "Simple User",
51357
+ "description": "Simple User",
51358
+ "type": "object",
51359
+ "properties": {
51360
+ "name": {
51361
+ "nullable": true,
51362
+ "type": "string"
51363
+ },
51364
+ "email": {
51365
+ "nullable": true,
51366
+ "type": "string"
51367
+ },
51368
+ "login": {
51369
+ "type": "string",
51370
+ "example": "octocat"
51371
+ },
51372
+ "id": {
51373
+ "type": "integer",
51374
+ "example": 1
51375
+ },
51376
+ "node_id": {
51377
+ "type": "string",
51378
+ "example": "MDQ6VXNlcjE="
51379
+ },
51380
+ "avatar_url": {
51381
+ "type": "string",
51382
+ "format": "uri",
51383
+ "example": "https://github.com/images/error/octocat_happy.gif"
51384
+ },
51385
+ "gravatar_id": {
51386
+ "type": "string",
51387
+ "example": "41d064eb2195891e12d0413f63227ea7",
51388
+ "nullable": true
51389
+ },
51390
+ "url": {
51391
+ "type": "string",
51392
+ "format": "uri",
51393
+ "example": "https://api.github.com/users/octocat"
51394
+ },
51395
+ "html_url": {
51396
+ "type": "string",
51397
+ "format": "uri",
51398
+ "example": "https://github.com/octocat"
51399
+ },
51400
+ "followers_url": {
51401
+ "type": "string",
51402
+ "format": "uri",
51403
+ "example": "https://api.github.com/users/octocat/followers"
51404
+ },
51405
+ "following_url": {
51406
+ "type": "string",
51407
+ "example": "https://api.github.com/users/octocat/following{/other_user}"
51408
+ },
51409
+ "gists_url": {
51410
+ "type": "string",
51411
+ "example": "https://api.github.com/users/octocat/gists{/gist_id}"
51412
+ },
51413
+ "starred_url": {
51414
+ "type": "string",
51415
+ "example": "https://api.github.com/users/octocat/starred{/owner}{/repo}"
51416
+ },
51417
+ "subscriptions_url": {
51418
+ "type": "string",
51419
+ "format": "uri",
51420
+ "example": "https://api.github.com/users/octocat/subscriptions"
51421
+ },
51422
+ "organizations_url": {
51423
+ "type": "string",
51424
+ "format": "uri",
51425
+ "example": "https://api.github.com/users/octocat/orgs"
51426
+ },
51427
+ "repos_url": {
51428
+ "type": "string",
51429
+ "format": "uri",
51430
+ "example": "https://api.github.com/users/octocat/repos"
51431
+ },
51432
+ "events_url": {
51433
+ "type": "string",
51434
+ "example": "https://api.github.com/users/octocat/events{/privacy}"
51435
+ },
51436
+ "received_events_url": {
51437
+ "type": "string",
51438
+ "format": "uri",
51439
+ "example": "https://api.github.com/users/octocat/received_events"
51440
+ },
51441
+ "type": {
51442
+ "type": "string",
51443
+ "example": "User"
51444
+ },
51445
+ "site_admin": {
51446
+ "type": "boolean"
51447
+ },
51448
+ "starred_at": {
51449
+ "type": "string",
51450
+ "example": "\"2020-07-09T00:17:55Z\""
51451
+ }
51452
+ },
51453
+ "required": [
51454
+ "avatar_url",
51455
+ "events_url",
51456
+ "followers_url",
51457
+ "following_url",
51458
+ "gists_url",
51459
+ "gravatar_id",
51460
+ "html_url",
51461
+ "id",
51462
+ "node_id",
51463
+ "login",
51464
+ "organizations_url",
51465
+ "received_events_url",
51466
+ "repos_url",
51467
+ "site_admin",
51468
+ "starred_url",
51469
+ "subscriptions_url",
51470
+ "type",
51471
+ "url"
51472
+ ]
51473
+ },
51474
+ "created_at": {
51475
+ "type": "string",
51476
+ "format": "date-time"
51477
+ },
51478
+ "updated_at": {
51479
+ "type": "string",
51480
+ "format": "date-time"
51311
51481
  }
51312
51482
  },
51313
51483
  "required": [
@@ -51325,11 +51495,70 @@
51325
51495
  "custom_roles": [
51326
51496
  {
51327
51497
  "id": 8030,
51328
- "name": "Developer"
51498
+ "name": "Security Engineer",
51499
+ "description": "Able to contribute code and maintain the security pipeline",
51500
+ "base_role": "maintain",
51501
+ "permissions": [
51502
+ "delete_alerts_code_scanning"
51503
+ ],
51504
+ "organization": {
51505
+ "login": "github",
51506
+ "id": 9919,
51507
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
51508
+ "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
51509
+ "gravatar_id": "",
51510
+ "url": "https://api.github.com/users/github",
51511
+ "html_url": "https://github.com/github",
51512
+ "followers_url": "https://api.github.com/users/github/followers",
51513
+ "following_url": "https://api.github.com/users/github/following{/other_user}",
51514
+ "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
51515
+ "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
51516
+ "subscriptions_url": "https://api.github.com/users/github/subscriptions",
51517
+ "organizations_url": "https://api.github.com/users/github/orgs",
51518
+ "repos_url": "https://api.github.com/users/github/repos",
51519
+ "events_url": "https://api.github.com/users/github/events{/privacy}",
51520
+ "received_events_url": "https://api.github.com/users/github/received_events",
51521
+ "type": "Organization",
51522
+ "site_admin": false
51523
+ },
51524
+ "created_at": "2022-07-04T22:19:11Z",
51525
+ "updated_at": "2022-07-04T22:20:11Z"
51329
51526
  },
51330
51527
  {
51331
51528
  "id": 8031,
51332
- "name": "Designer"
51529
+ "name": "Community manager",
51530
+ "description": "Able to handle all the community interactions without being able to contribute code",
51531
+ "base_role": "read",
51532
+ "permissions": [
51533
+ "mark_as_duplicate",
51534
+ "manage_settings_pages",
51535
+ "manage_settings_wiki",
51536
+ "set_social_preview",
51537
+ "edit_repo_metadata",
51538
+ "toggle_discussion_comment_minimize"
51539
+ ],
51540
+ "organization": {
51541
+ "login": "github",
51542
+ "id": 9919,
51543
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
51544
+ "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
51545
+ "gravatar_id": "",
51546
+ "url": "https://api.github.com/users/github",
51547
+ "html_url": "https://github.com/github",
51548
+ "followers_url": "https://api.github.com/users/github/followers",
51549
+ "following_url": "https://api.github.com/users/github/following{/other_user}",
51550
+ "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
51551
+ "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
51552
+ "subscriptions_url": "https://api.github.com/users/github/subscriptions",
51553
+ "organizations_url": "https://api.github.com/users/github/orgs",
51554
+ "repos_url": "https://api.github.com/users/github/repos",
51555
+ "events_url": "https://api.github.com/users/github/events{/privacy}",
51556
+ "received_events_url": "https://api.github.com/users/github/received_events",
51557
+ "type": "Organization",
51558
+ "site_admin": false
51559
+ },
51560
+ "created_at": "2022-07-05T12:01:11Z",
51561
+ "updated_at": "2022-07-05T12:20:11Z"
51333
51562
  }
51334
51563
  ]
51335
51564
  }
@@ -54093,8 +54322,9 @@
54093
54322
  },
54094
54323
  "use_squash_pr_title_as_default": {
54095
54324
  "type": "boolean",
54096
- "description": "Whether a squash merge commit can use the pull request title as default.",
54097
- "default": false
54325
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
54326
+ "default": false,
54327
+ "deprecated": true
54098
54328
  },
54099
54329
  "squash_merge_commit_title": {
54100
54330
  "type": "string",
@@ -57133,8 +57363,9 @@
57133
57363
  },
57134
57364
  "use_squash_pr_title_as_default": {
57135
57365
  "type": "boolean",
57136
- "description": "Whether a squash merge commit can use the pull request title as default.",
57137
- "default": false
57366
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
57367
+ "default": false,
57368
+ "deprecated": true
57138
57369
  },
57139
57370
  "squash_merge_commit_title": {
57140
57371
  "type": "string",
@@ -59697,8 +59928,9 @@
59697
59928
  },
59698
59929
  "use_squash_pr_title_as_default": {
59699
59930
  "type": "boolean",
59700
- "description": "Whether a squash merge commit can use the pull request title as default.",
59701
- "default": false
59931
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
59932
+ "default": false,
59933
+ "deprecated": true
59702
59934
  },
59703
59935
  "squash_merge_commit_title": {
59704
59936
  "type": "string",
@@ -60985,8 +61217,9 @@
60985
61217
  },
60986
61218
  "use_squash_pr_title_as_default": {
60987
61219
  "type": "boolean",
60988
- "description": "Whether a squash merge commit can use the pull request title as default.",
60989
- "default": false
61220
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
61221
+ "default": false,
61222
+ "deprecated": true
60990
61223
  },
60991
61224
  "squash_merge_commit_title": {
60992
61225
  "type": "string",
@@ -64305,8 +64538,9 @@
64305
64538
  },
64306
64539
  "use_squash_pr_title_as_default": {
64307
64540
  "type": "boolean",
64308
- "description": "Whether a squash merge commit can use the pull request title as default.",
64309
- "default": false
64541
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
64542
+ "default": false,
64543
+ "deprecated": true
64310
64544
  },
64311
64545
  "squash_merge_commit_title": {
64312
64546
  "type": "string",
@@ -68657,8 +68891,9 @@
68657
68891
  },
68658
68892
  "use_squash_pr_title_as_default": {
68659
68893
  "type": "boolean",
68660
- "description": "Whether a squash merge commit can use the pull request title as default.",
68661
- "default": false
68894
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
68895
+ "default": false,
68896
+ "deprecated": true
68662
68897
  },
68663
68898
  "squash_merge_commit_title": {
68664
68899
  "type": "string",
@@ -69763,198 +69998,1061 @@
69763
69998
  }
69764
69999
  }
69765
70000
  }
69766
- }
69767
- },
69768
- "x-github": {
69769
- "githubCloudOnly": false,
69770
- "enabledForGitHubApps": false,
69771
- "category": "codespaces",
69772
- "subcategory": "organizations"
69773
- },
69774
- "x-octokit": {
69775
- "changes": [
69776
- {
69777
- "type": "PARAMETER",
69778
- "date": "2022-07-01",
69779
- "parameter": "org",
69780
- "before": {
69781
- "name": "org_id"
69782
- }
69783
- }
69784
- ]
69785
- }
69786
- }
69787
- },
69788
- "/orgs/{org}/credential-authorizations": {
69789
- "get": {
69790
- "summary": "List SAML SSO authorizations for an organization",
69791
- "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).",
69792
- "tags": [
69793
- "orgs"
69794
- ],
69795
- "operationId": "orgs/list-saml-sso-authorizations",
69796
- "externalDocs": {
69797
- "description": "API method documentation",
69798
- "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization"
69799
- },
69800
- "parameters": [
69801
- {
69802
- "name": "org",
69803
- "description": "The organization name. The name is not case sensitive.",
69804
- "in": "path",
69805
- "required": true,
69806
- "schema": {
69807
- "type": "string"
69808
- }
70001
+ }
70002
+ },
70003
+ "x-github": {
70004
+ "githubCloudOnly": false,
70005
+ "enabledForGitHubApps": false,
70006
+ "category": "codespaces",
70007
+ "subcategory": "organizations"
70008
+ },
70009
+ "x-octokit": {
70010
+ "changes": [
70011
+ {
70012
+ "type": "PARAMETER",
70013
+ "date": "2022-07-01",
70014
+ "parameter": "org",
70015
+ "before": {
70016
+ "name": "org_id"
70017
+ }
70018
+ }
70019
+ ]
70020
+ }
70021
+ }
70022
+ },
70023
+ "/orgs/{org}/credential-authorizations": {
70024
+ "get": {
70025
+ "summary": "List SAML SSO authorizations for an organization",
70026
+ "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `read:org` scope can list all credential authorizations for an organization that uses SAML single sign-on (SSO). The credentials are either personal access tokens or SSH keys that organization members have authorized for the organization. For more information, see [About authentication with SAML single sign-on](https://docs.github.com/en/articles/about-authentication-with-saml-single-sign-on).",
70027
+ "tags": [
70028
+ "orgs"
70029
+ ],
70030
+ "operationId": "orgs/list-saml-sso-authorizations",
70031
+ "externalDocs": {
70032
+ "description": "API method documentation",
70033
+ "url": "https://docs.github.com/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization"
70034
+ },
70035
+ "parameters": [
70036
+ {
70037
+ "name": "org",
70038
+ "description": "The organization name. The name is not case sensitive.",
70039
+ "in": "path",
70040
+ "required": true,
70041
+ "schema": {
70042
+ "type": "string"
70043
+ }
70044
+ },
70045
+ {
70046
+ "name": "per_page",
70047
+ "description": "The number of results per page (max 100).",
70048
+ "in": "query",
70049
+ "schema": {
70050
+ "type": "integer",
70051
+ "default": 30
70052
+ }
70053
+ },
70054
+ {
70055
+ "name": "page",
70056
+ "description": "Page token",
70057
+ "in": "query",
70058
+ "schema": {
70059
+ "type": "integer"
70060
+ }
70061
+ },
70062
+ {
70063
+ "name": "login",
70064
+ "description": "Limits the list of credentials authorizations for an organization to a specific login",
70065
+ "in": "query",
70066
+ "schema": {
70067
+ "type": "string"
70068
+ }
70069
+ }
70070
+ ],
70071
+ "responses": {
70072
+ "200": {
70073
+ "description": "Response",
70074
+ "content": {
70075
+ "application/json": {
70076
+ "schema": {
70077
+ "type": "array",
70078
+ "items": {
70079
+ "title": "Credential Authorization",
70080
+ "description": "Credential Authorization",
70081
+ "type": "object",
70082
+ "properties": {
70083
+ "login": {
70084
+ "type": "string",
70085
+ "example": "monalisa",
70086
+ "description": "User login that owns the underlying credential."
70087
+ },
70088
+ "credential_id": {
70089
+ "type": "integer",
70090
+ "example": 1,
70091
+ "description": "Unique identifier for the credential."
70092
+ },
70093
+ "credential_type": {
70094
+ "type": "string",
70095
+ "example": "SSH Key",
70096
+ "description": "Human-readable description of the credential type."
70097
+ },
70098
+ "token_last_eight": {
70099
+ "type": "string",
70100
+ "example": "12345678",
70101
+ "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token."
70102
+ },
70103
+ "credential_authorized_at": {
70104
+ "type": "string",
70105
+ "format": "date-time",
70106
+ "example": "2011-01-26T19:06:43Z",
70107
+ "description": "Date when the credential was authorized for use."
70108
+ },
70109
+ "scopes": {
70110
+ "type": "array",
70111
+ "example": [
70112
+ "user",
70113
+ "repo"
70114
+ ],
70115
+ "description": "List of oauth scopes the token has been granted.",
70116
+ "items": {
70117
+ "type": "string"
70118
+ }
70119
+ },
70120
+ "fingerprint": {
70121
+ "type": "string",
70122
+ "example": "jklmnop12345678",
70123
+ "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key."
70124
+ },
70125
+ "credential_accessed_at": {
70126
+ "type": "string",
70127
+ "format": "date-time",
70128
+ "example": "2011-01-26T19:06:43Z",
70129
+ "description": "Date when the credential was last accessed. May be null if it was never accessed",
70130
+ "nullable": true
70131
+ },
70132
+ "authorized_credential_id": {
70133
+ "type": "integer",
70134
+ "nullable": true,
70135
+ "example": 12345678
70136
+ },
70137
+ "authorized_credential_title": {
70138
+ "type": "string",
70139
+ "nullable": true,
70140
+ "example": "my ssh key",
70141
+ "description": "The title given to the ssh key. This will only be present when the credential is an ssh key."
70142
+ },
70143
+ "authorized_credential_note": {
70144
+ "type": "string",
70145
+ "nullable": true,
70146
+ "example": "my token",
70147
+ "description": "The note given to the token. This will only be present when the credential is a token."
70148
+ },
70149
+ "authorized_credential_expires_at": {
70150
+ "type": "string",
70151
+ "format": "date-time",
70152
+ "nullable": true,
70153
+ "description": "The expiry for the token. This will only be present when the credential is a token."
70154
+ }
70155
+ },
70156
+ "required": [
70157
+ "login",
70158
+ "credential_id",
70159
+ "credential_type",
70160
+ "credential_authorized_at",
70161
+ "credential_accessed_at",
70162
+ "authorized_credential_id"
70163
+ ]
70164
+ }
70165
+ },
70166
+ "examples": {
70167
+ "default": {
70168
+ "value": [
70169
+ {
70170
+ "login": "octocat",
70171
+ "credential_id": 161195,
70172
+ "credential_type": "personal access token",
70173
+ "token_last_eight": "71c3fc11",
70174
+ "credential_authorized_at": "2011-01-26T19:06:43Z",
70175
+ "authorized_credential_expires_at": "2011-02-25T19:06:43Z",
70176
+ "scopes": [
70177
+ "user",
70178
+ "repo"
70179
+ ]
70180
+ },
70181
+ {
70182
+ "login": "hubot",
70183
+ "credential_id": 161196,
70184
+ "credential_type": "personal access token",
70185
+ "token_last_eight": "Ae178B4a",
70186
+ "credential_authorized_at": "2019-03-29T19:06:43Z",
70187
+ "authorized_credential_expires_at": "2019-04-28T19:06:43Z",
70188
+ "scopes": [
70189
+ "repo"
70190
+ ]
70191
+ }
70192
+ ]
70193
+ }
70194
+ }
70195
+ }
70196
+ }
70197
+ }
70198
+ },
70199
+ "x-github": {
70200
+ "githubCloudOnly": true,
70201
+ "enabledForGitHubApps": true,
70202
+ "category": "orgs",
70203
+ "subcategory": null
70204
+ },
70205
+ "x-octokit": {}
70206
+ }
70207
+ },
70208
+ "/orgs/{org}/credential-authorizations/{credential_id}": {
70209
+ "delete": {
70210
+ "summary": "Remove a SAML SSO authorization for an organization",
70211
+ "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.",
70212
+ "tags": [
70213
+ "orgs"
70214
+ ],
70215
+ "operationId": "orgs/remove-saml-sso-authorization",
70216
+ "externalDocs": {
70217
+ "description": "API method documentation",
70218
+ "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization"
70219
+ },
70220
+ "parameters": [
70221
+ {
70222
+ "name": "org",
70223
+ "description": "The organization name. The name is not case sensitive.",
70224
+ "in": "path",
70225
+ "required": true,
70226
+ "schema": {
70227
+ "type": "string"
70228
+ }
70229
+ },
70230
+ {
70231
+ "name": "credential_id",
70232
+ "in": "path",
70233
+ "required": true,
70234
+ "schema": {
70235
+ "type": "integer"
70236
+ }
70237
+ }
70238
+ ],
70239
+ "responses": {
70240
+ "204": {
70241
+ "description": "Response"
70242
+ },
70243
+ "404": {
70244
+ "description": "Resource not found",
70245
+ "content": {
70246
+ "application/json": {
70247
+ "schema": {
70248
+ "title": "Basic Error",
70249
+ "description": "Basic Error",
70250
+ "type": "object",
70251
+ "properties": {
70252
+ "message": {
70253
+ "type": "string"
70254
+ },
70255
+ "documentation_url": {
70256
+ "type": "string"
70257
+ },
70258
+ "url": {
70259
+ "type": "string"
70260
+ },
70261
+ "status": {
70262
+ "type": "string"
70263
+ }
70264
+ }
70265
+ }
70266
+ }
70267
+ }
70268
+ }
70269
+ },
70270
+ "x-github": {
70271
+ "githubCloudOnly": true,
70272
+ "enabledForGitHubApps": true,
70273
+ "category": "orgs",
70274
+ "subcategory": null
70275
+ },
70276
+ "x-octokit": {}
70277
+ }
70278
+ },
70279
+ "/orgs/{org}/custom_roles": {
70280
+ "post": {
70281
+ "summary": "Create a custom role",
70282
+ "description": "**Note**: This operation is in beta and is subject to change.\n\nCreates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information on custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"",
70283
+ "tags": [
70284
+ "orgs"
70285
+ ],
70286
+ "operationId": "orgs/create-custom-role",
70287
+ "externalDocs": {
70288
+ "description": "API method documentation",
70289
+ "url": "https://docs.github.com/rest/reference/orgs#create-a-custom-role"
70290
+ },
70291
+ "parameters": [
70292
+ {
70293
+ "name": "org",
70294
+ "description": "The organization name. The name is not case sensitive.",
70295
+ "in": "path",
70296
+ "required": true,
70297
+ "schema": {
70298
+ "type": "string"
70299
+ }
70300
+ }
70301
+ ],
70302
+ "requestBody": {
70303
+ "required": true,
70304
+ "content": {
70305
+ "application/json": {
70306
+ "schema": {
70307
+ "type": "object",
70308
+ "properties": {
70309
+ "name": {
70310
+ "type": "string",
70311
+ "description": "The name of the custom role."
70312
+ },
70313
+ "description": {
70314
+ "type": "string",
70315
+ "description": "A short description about the intended usage of this role or what permissions it grants."
70316
+ },
70317
+ "base_role": {
70318
+ "type": "string",
70319
+ "enum": [
70320
+ "read",
70321
+ "triage",
70322
+ "write",
70323
+ "maintain"
70324
+ ],
70325
+ "description": "The system role from which this role inherits permissions."
70326
+ },
70327
+ "permissions": {
70328
+ "type": "array",
70329
+ "description": "A list of additional permissions included in this role.",
70330
+ "items": {
70331
+ "type": "string"
70332
+ }
70333
+ }
70334
+ },
70335
+ "required": [
70336
+ "name",
70337
+ "base_role",
70338
+ "permissions"
70339
+ ]
70340
+ },
70341
+ "examples": {
70342
+ "default": {
70343
+ "value": {
70344
+ "name": "Labeler",
70345
+ "description": "A role for issue and PR labelers",
70346
+ "base_role": "read",
70347
+ "permissions": [
70348
+ "add_label"
70349
+ ]
70350
+ }
70351
+ }
70352
+ }
70353
+ }
70354
+ }
70355
+ },
70356
+ "responses": {
70357
+ "201": {
70358
+ "description": "Response",
70359
+ "content": {
70360
+ "application/json": {
70361
+ "schema": {
70362
+ "title": "Organization Custom Repository Role",
70363
+ "description": "Custom repository roles created by organization administrators",
70364
+ "type": "object",
70365
+ "properties": {
70366
+ "id": {
70367
+ "description": "The unique identifier of the custom role.",
70368
+ "type": "integer"
70369
+ },
70370
+ "name": {
70371
+ "description": "The name of the custom role.",
70372
+ "type": "string"
70373
+ },
70374
+ "description": {
70375
+ "description": "A short description about who this role is for or what permissions it grants.",
70376
+ "type": "string",
70377
+ "nullable": true
70378
+ },
70379
+ "base_role": {
70380
+ "type": "string",
70381
+ "description": "The system role from which this role inherits permissions.",
70382
+ "enum": [
70383
+ "read",
70384
+ "triage",
70385
+ "write",
70386
+ "maintain"
70387
+ ]
70388
+ },
70389
+ "permissions": {
70390
+ "description": "A list of additional permissions included in this role.",
70391
+ "type": "array",
70392
+ "items": {
70393
+ "type": "string"
70394
+ }
70395
+ },
70396
+ "organization": {
70397
+ "title": "Simple User",
70398
+ "description": "Simple User",
70399
+ "type": "object",
70400
+ "properties": {
70401
+ "name": {
70402
+ "nullable": true,
70403
+ "type": "string"
70404
+ },
70405
+ "email": {
70406
+ "nullable": true,
70407
+ "type": "string"
70408
+ },
70409
+ "login": {
70410
+ "type": "string",
70411
+ "example": "octocat"
70412
+ },
70413
+ "id": {
70414
+ "type": "integer",
70415
+ "example": 1
70416
+ },
70417
+ "node_id": {
70418
+ "type": "string",
70419
+ "example": "MDQ6VXNlcjE="
70420
+ },
70421
+ "avatar_url": {
70422
+ "type": "string",
70423
+ "format": "uri",
70424
+ "example": "https://github.com/images/error/octocat_happy.gif"
70425
+ },
70426
+ "gravatar_id": {
70427
+ "type": "string",
70428
+ "example": "41d064eb2195891e12d0413f63227ea7",
70429
+ "nullable": true
70430
+ },
70431
+ "url": {
70432
+ "type": "string",
70433
+ "format": "uri",
70434
+ "example": "https://api.github.com/users/octocat"
70435
+ },
70436
+ "html_url": {
70437
+ "type": "string",
70438
+ "format": "uri",
70439
+ "example": "https://github.com/octocat"
70440
+ },
70441
+ "followers_url": {
70442
+ "type": "string",
70443
+ "format": "uri",
70444
+ "example": "https://api.github.com/users/octocat/followers"
70445
+ },
70446
+ "following_url": {
70447
+ "type": "string",
70448
+ "example": "https://api.github.com/users/octocat/following{/other_user}"
70449
+ },
70450
+ "gists_url": {
70451
+ "type": "string",
70452
+ "example": "https://api.github.com/users/octocat/gists{/gist_id}"
70453
+ },
70454
+ "starred_url": {
70455
+ "type": "string",
70456
+ "example": "https://api.github.com/users/octocat/starred{/owner}{/repo}"
70457
+ },
70458
+ "subscriptions_url": {
70459
+ "type": "string",
70460
+ "format": "uri",
70461
+ "example": "https://api.github.com/users/octocat/subscriptions"
70462
+ },
70463
+ "organizations_url": {
70464
+ "type": "string",
70465
+ "format": "uri",
70466
+ "example": "https://api.github.com/users/octocat/orgs"
70467
+ },
70468
+ "repos_url": {
70469
+ "type": "string",
70470
+ "format": "uri",
70471
+ "example": "https://api.github.com/users/octocat/repos"
70472
+ },
70473
+ "events_url": {
70474
+ "type": "string",
70475
+ "example": "https://api.github.com/users/octocat/events{/privacy}"
70476
+ },
70477
+ "received_events_url": {
70478
+ "type": "string",
70479
+ "format": "uri",
70480
+ "example": "https://api.github.com/users/octocat/received_events"
70481
+ },
70482
+ "type": {
70483
+ "type": "string",
70484
+ "example": "User"
70485
+ },
70486
+ "site_admin": {
70487
+ "type": "boolean"
70488
+ },
70489
+ "starred_at": {
70490
+ "type": "string",
70491
+ "example": "\"2020-07-09T00:17:55Z\""
70492
+ }
70493
+ },
70494
+ "required": [
70495
+ "avatar_url",
70496
+ "events_url",
70497
+ "followers_url",
70498
+ "following_url",
70499
+ "gists_url",
70500
+ "gravatar_id",
70501
+ "html_url",
70502
+ "id",
70503
+ "node_id",
70504
+ "login",
70505
+ "organizations_url",
70506
+ "received_events_url",
70507
+ "repos_url",
70508
+ "site_admin",
70509
+ "starred_url",
70510
+ "subscriptions_url",
70511
+ "type",
70512
+ "url"
70513
+ ]
70514
+ },
70515
+ "created_at": {
70516
+ "type": "string",
70517
+ "format": "date-time"
70518
+ },
70519
+ "updated_at": {
70520
+ "type": "string",
70521
+ "format": "date-time"
70522
+ }
70523
+ },
70524
+ "required": [
70525
+ "id",
70526
+ "name"
70527
+ ]
70528
+ },
70529
+ "examples": {
70530
+ "default": {
70531
+ "value": {
70532
+ "id": 8030,
70533
+ "name": "Labeler",
70534
+ "description": "A role for issue and PR labelers",
70535
+ "base_role": "read",
70536
+ "permissions": [
70537
+ "add_label"
70538
+ ],
70539
+ "organization": {
70540
+ "login": "github",
70541
+ "id": 9919,
70542
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
70543
+ "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
70544
+ "gravatar_id": "",
70545
+ "url": "https://api.github.com/users/github",
70546
+ "html_url": "https://github.com/github",
70547
+ "followers_url": "https://api.github.com/users/github/followers",
70548
+ "following_url": "https://api.github.com/users/github/following{/other_user}",
70549
+ "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
70550
+ "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
70551
+ "subscriptions_url": "https://api.github.com/users/github/subscriptions",
70552
+ "organizations_url": "https://api.github.com/users/github/orgs",
70553
+ "repos_url": "https://api.github.com/users/github/repos",
70554
+ "events_url": "https://api.github.com/users/github/events{/privacy}",
70555
+ "received_events_url": "https://api.github.com/users/github/received_events",
70556
+ "type": "Organization",
70557
+ "site_admin": false
70558
+ },
70559
+ "created_at": "2022-07-04T22:19:11Z",
70560
+ "updated_at": "2022-07-04T22:19:11Z"
70561
+ }
70562
+ }
70563
+ }
70564
+ }
70565
+ }
70566
+ },
70567
+ "404": {
70568
+ "description": "Resource not found",
70569
+ "content": {
70570
+ "application/json": {
70571
+ "schema": {
70572
+ "title": "Basic Error",
70573
+ "description": "Basic Error",
70574
+ "type": "object",
70575
+ "properties": {
70576
+ "message": {
70577
+ "type": "string"
70578
+ },
70579
+ "documentation_url": {
70580
+ "type": "string"
70581
+ },
70582
+ "url": {
70583
+ "type": "string"
70584
+ },
70585
+ "status": {
70586
+ "type": "string"
70587
+ }
70588
+ }
70589
+ }
70590
+ }
70591
+ }
70592
+ },
70593
+ "422": {
70594
+ "description": "Validation failed",
70595
+ "content": {
70596
+ "application/json": {
70597
+ "schema": {
70598
+ "title": "Validation Error",
70599
+ "description": "Validation Error",
70600
+ "type": "object",
70601
+ "required": [
70602
+ "message",
70603
+ "documentation_url"
70604
+ ],
70605
+ "properties": {
70606
+ "message": {
70607
+ "type": "string"
70608
+ },
70609
+ "documentation_url": {
70610
+ "type": "string"
70611
+ },
70612
+ "errors": {
70613
+ "type": "array",
70614
+ "items": {
70615
+ "type": "object",
70616
+ "required": [
70617
+ "code"
70618
+ ],
70619
+ "properties": {
70620
+ "resource": {
70621
+ "type": "string"
70622
+ },
70623
+ "field": {
70624
+ "type": "string"
70625
+ },
70626
+ "message": {
70627
+ "type": "string"
70628
+ },
70629
+ "code": {
70630
+ "type": "string"
70631
+ },
70632
+ "index": {
70633
+ "type": "integer"
70634
+ },
70635
+ "value": {
70636
+ "oneOf": [
70637
+ {
70638
+ "type": "string",
70639
+ "nullable": true
70640
+ },
70641
+ {
70642
+ "type": "integer",
70643
+ "nullable": true
70644
+ },
70645
+ {
70646
+ "type": "array",
70647
+ "nullable": true,
70648
+ "items": {
70649
+ "type": "string"
70650
+ }
70651
+ }
70652
+ ]
70653
+ }
70654
+ }
70655
+ }
70656
+ }
70657
+ }
70658
+ }
70659
+ }
70660
+ }
70661
+ }
70662
+ },
70663
+ "x-github": {
70664
+ "githubCloudOnly": false,
70665
+ "enabledForGitHubApps": true,
70666
+ "category": "orgs",
70667
+ "subcategory": "custom-roles"
70668
+ },
70669
+ "x-octokit": {}
70670
+ }
70671
+ },
70672
+ "/orgs/{org}/custom_roles/{role_id}": {
70673
+ "patch": {
70674
+ "summary": "Update a custom role",
70675
+ "description": "**Note**: This operation is in beta and subject to change.\n\nUpdates a custom repository role that can be used by all repositories owned by the organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"",
70676
+ "tags": [
70677
+ "orgs"
70678
+ ],
70679
+ "operationId": "orgs/update-custom-role",
70680
+ "externalDocs": {
70681
+ "description": "API method documentation",
70682
+ "url": "https://docs.github.com/rest/reference/orgs#update-a-custom-role"
70683
+ },
70684
+ "parameters": [
70685
+ {
70686
+ "name": "org",
70687
+ "description": "The organization name. The name is not case sensitive.",
70688
+ "in": "path",
70689
+ "required": true,
70690
+ "schema": {
70691
+ "type": "string"
70692
+ }
70693
+ },
70694
+ {
70695
+ "name": "role_id",
70696
+ "description": "The unique identifier of the role.",
70697
+ "in": "path",
70698
+ "required": true,
70699
+ "schema": {
70700
+ "type": "integer"
70701
+ }
70702
+ }
70703
+ ],
70704
+ "requestBody": {
70705
+ "required": true,
70706
+ "content": {
70707
+ "application/json": {
70708
+ "schema": {
70709
+ "type": "object",
70710
+ "properties": {
70711
+ "name": {
70712
+ "type": "string",
70713
+ "description": "The name of the custom role."
70714
+ },
70715
+ "description": {
70716
+ "type": "string",
70717
+ "description": "A short description about who this role is for or what permissions it grants."
70718
+ },
70719
+ "base_role": {
70720
+ "type": "string",
70721
+ "enum": [
70722
+ "read",
70723
+ "triage",
70724
+ "write",
70725
+ "maintain"
70726
+ ],
70727
+ "description": "The system role from which this role inherits permissions."
70728
+ },
70729
+ "permissions": {
70730
+ "type": "array",
70731
+ "description": "A list of additional permissions included in this role. If specified, these permissions will replace any currently set on the role.",
70732
+ "items": {
70733
+ "type": "string"
70734
+ }
70735
+ }
70736
+ }
70737
+ },
70738
+ "examples": {
70739
+ "default": {
70740
+ "value": {
70741
+ "name": "Labeler",
70742
+ "description": "A role for issue and PR labelers",
70743
+ "base_role": "read",
70744
+ "permissions": [
70745
+ "add_label",
70746
+ "remove_label"
70747
+ ]
70748
+ }
70749
+ }
70750
+ }
70751
+ }
70752
+ }
70753
+ },
70754
+ "responses": {
70755
+ "200": {
70756
+ "description": "Response",
70757
+ "content": {
70758
+ "application/json": {
70759
+ "schema": {
70760
+ "title": "Organization Custom Repository Role",
70761
+ "description": "Custom repository roles created by organization administrators",
70762
+ "type": "object",
70763
+ "properties": {
70764
+ "id": {
70765
+ "description": "The unique identifier of the custom role.",
70766
+ "type": "integer"
70767
+ },
70768
+ "name": {
70769
+ "description": "The name of the custom role.",
70770
+ "type": "string"
70771
+ },
70772
+ "description": {
70773
+ "description": "A short description about who this role is for or what permissions it grants.",
70774
+ "type": "string",
70775
+ "nullable": true
70776
+ },
70777
+ "base_role": {
70778
+ "type": "string",
70779
+ "description": "The system role from which this role inherits permissions.",
70780
+ "enum": [
70781
+ "read",
70782
+ "triage",
70783
+ "write",
70784
+ "maintain"
70785
+ ]
70786
+ },
70787
+ "permissions": {
70788
+ "description": "A list of additional permissions included in this role.",
70789
+ "type": "array",
70790
+ "items": {
70791
+ "type": "string"
70792
+ }
70793
+ },
70794
+ "organization": {
70795
+ "title": "Simple User",
70796
+ "description": "Simple User",
70797
+ "type": "object",
70798
+ "properties": {
70799
+ "name": {
70800
+ "nullable": true,
70801
+ "type": "string"
70802
+ },
70803
+ "email": {
70804
+ "nullable": true,
70805
+ "type": "string"
70806
+ },
70807
+ "login": {
70808
+ "type": "string",
70809
+ "example": "octocat"
70810
+ },
70811
+ "id": {
70812
+ "type": "integer",
70813
+ "example": 1
70814
+ },
70815
+ "node_id": {
70816
+ "type": "string",
70817
+ "example": "MDQ6VXNlcjE="
70818
+ },
70819
+ "avatar_url": {
70820
+ "type": "string",
70821
+ "format": "uri",
70822
+ "example": "https://github.com/images/error/octocat_happy.gif"
70823
+ },
70824
+ "gravatar_id": {
70825
+ "type": "string",
70826
+ "example": "41d064eb2195891e12d0413f63227ea7",
70827
+ "nullable": true
70828
+ },
70829
+ "url": {
70830
+ "type": "string",
70831
+ "format": "uri",
70832
+ "example": "https://api.github.com/users/octocat"
70833
+ },
70834
+ "html_url": {
70835
+ "type": "string",
70836
+ "format": "uri",
70837
+ "example": "https://github.com/octocat"
70838
+ },
70839
+ "followers_url": {
70840
+ "type": "string",
70841
+ "format": "uri",
70842
+ "example": "https://api.github.com/users/octocat/followers"
70843
+ },
70844
+ "following_url": {
70845
+ "type": "string",
70846
+ "example": "https://api.github.com/users/octocat/following{/other_user}"
70847
+ },
70848
+ "gists_url": {
70849
+ "type": "string",
70850
+ "example": "https://api.github.com/users/octocat/gists{/gist_id}"
70851
+ },
70852
+ "starred_url": {
70853
+ "type": "string",
70854
+ "example": "https://api.github.com/users/octocat/starred{/owner}{/repo}"
70855
+ },
70856
+ "subscriptions_url": {
70857
+ "type": "string",
70858
+ "format": "uri",
70859
+ "example": "https://api.github.com/users/octocat/subscriptions"
70860
+ },
70861
+ "organizations_url": {
70862
+ "type": "string",
70863
+ "format": "uri",
70864
+ "example": "https://api.github.com/users/octocat/orgs"
70865
+ },
70866
+ "repos_url": {
70867
+ "type": "string",
70868
+ "format": "uri",
70869
+ "example": "https://api.github.com/users/octocat/repos"
70870
+ },
70871
+ "events_url": {
70872
+ "type": "string",
70873
+ "example": "https://api.github.com/users/octocat/events{/privacy}"
70874
+ },
70875
+ "received_events_url": {
70876
+ "type": "string",
70877
+ "format": "uri",
70878
+ "example": "https://api.github.com/users/octocat/received_events"
70879
+ },
70880
+ "type": {
70881
+ "type": "string",
70882
+ "example": "User"
70883
+ },
70884
+ "site_admin": {
70885
+ "type": "boolean"
70886
+ },
70887
+ "starred_at": {
70888
+ "type": "string",
70889
+ "example": "\"2020-07-09T00:17:55Z\""
70890
+ }
70891
+ },
70892
+ "required": [
70893
+ "avatar_url",
70894
+ "events_url",
70895
+ "followers_url",
70896
+ "following_url",
70897
+ "gists_url",
70898
+ "gravatar_id",
70899
+ "html_url",
70900
+ "id",
70901
+ "node_id",
70902
+ "login",
70903
+ "organizations_url",
70904
+ "received_events_url",
70905
+ "repos_url",
70906
+ "site_admin",
70907
+ "starred_url",
70908
+ "subscriptions_url",
70909
+ "type",
70910
+ "url"
70911
+ ]
70912
+ },
70913
+ "created_at": {
70914
+ "type": "string",
70915
+ "format": "date-time"
70916
+ },
70917
+ "updated_at": {
70918
+ "type": "string",
70919
+ "format": "date-time"
70920
+ }
70921
+ },
70922
+ "required": [
70923
+ "id",
70924
+ "name"
70925
+ ]
70926
+ },
70927
+ "examples": {
70928
+ "default": {
70929
+ "value": {
70930
+ "id": 8030,
70931
+ "name": "Labeler",
70932
+ "description": "A role for issue and PR labelers",
70933
+ "base_role": "read",
70934
+ "permissions": [
70935
+ "add_label",
70936
+ "remove_label"
70937
+ ],
70938
+ "organization": {
70939
+ "login": "github",
70940
+ "id": 9919,
70941
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
70942
+ "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
70943
+ "gravatar_id": "",
70944
+ "url": "https://api.github.com/users/github",
70945
+ "html_url": "https://github.com/github",
70946
+ "followers_url": "https://api.github.com/users/github/followers",
70947
+ "following_url": "https://api.github.com/users/github/following{/other_user}",
70948
+ "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
70949
+ "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
70950
+ "subscriptions_url": "https://api.github.com/users/github/subscriptions",
70951
+ "organizations_url": "https://api.github.com/users/github/orgs",
70952
+ "repos_url": "https://api.github.com/users/github/repos",
70953
+ "events_url": "https://api.github.com/users/github/events{/privacy}",
70954
+ "received_events_url": "https://api.github.com/users/github/received_events",
70955
+ "type": "Organization",
70956
+ "site_admin": false
70957
+ },
70958
+ "created_at": "2022-07-04T22:19:11Z",
70959
+ "updated_at": "2022-07-04T22:19:11Z"
70960
+ }
70961
+ }
70962
+ }
70963
+ }
70964
+ }
70965
+ },
70966
+ "404": {
70967
+ "description": "Resource not found",
70968
+ "content": {
70969
+ "application/json": {
70970
+ "schema": {
70971
+ "title": "Basic Error",
70972
+ "description": "Basic Error",
70973
+ "type": "object",
70974
+ "properties": {
70975
+ "message": {
70976
+ "type": "string"
70977
+ },
70978
+ "documentation_url": {
70979
+ "type": "string"
70980
+ },
70981
+ "url": {
70982
+ "type": "string"
70983
+ },
70984
+ "status": {
70985
+ "type": "string"
70986
+ }
70987
+ }
70988
+ }
70989
+ }
70990
+ }
69809
70991
  },
69810
- {
69811
- "name": "per_page",
69812
- "description": "The number of results per page (max 100).",
69813
- "in": "query",
69814
- "schema": {
69815
- "type": "integer",
69816
- "default": 30
69817
- }
69818
- },
69819
- {
69820
- "name": "page",
69821
- "description": "Page token",
69822
- "in": "query",
69823
- "schema": {
69824
- "type": "integer"
69825
- }
69826
- },
69827
- {
69828
- "name": "login",
69829
- "description": "Limits the list of credentials authorizations for an organization to a specific login",
69830
- "in": "query",
69831
- "schema": {
69832
- "type": "string"
69833
- }
69834
- }
69835
- ],
69836
- "responses": {
69837
- "200": {
69838
- "description": "Response",
70992
+ "422": {
70993
+ "description": "Validation failed",
69839
70994
  "content": {
69840
70995
  "application/json": {
69841
70996
  "schema": {
69842
- "type": "array",
69843
- "items": {
69844
- "title": "Credential Authorization",
69845
- "description": "Credential Authorization",
69846
- "type": "object",
69847
- "properties": {
69848
- "login": {
69849
- "type": "string",
69850
- "example": "monalisa",
69851
- "description": "User login that owns the underlying credential."
69852
- },
69853
- "credential_id": {
69854
- "type": "integer",
69855
- "example": 1,
69856
- "description": "Unique identifier for the credential."
69857
- },
69858
- "credential_type": {
69859
- "type": "string",
69860
- "example": "SSH Key",
69861
- "description": "Human-readable description of the credential type."
69862
- },
69863
- "token_last_eight": {
69864
- "type": "string",
69865
- "example": "12345678",
69866
- "description": "Last eight characters of the credential. Only included in responses with credential_type of personal access token."
69867
- },
69868
- "credential_authorized_at": {
69869
- "type": "string",
69870
- "format": "date-time",
69871
- "example": "2011-01-26T19:06:43Z",
69872
- "description": "Date when the credential was authorized for use."
69873
- },
69874
- "scopes": {
69875
- "type": "array",
69876
- "example": [
69877
- "user",
69878
- "repo"
70997
+ "title": "Validation Error",
70998
+ "description": "Validation Error",
70999
+ "type": "object",
71000
+ "required": [
71001
+ "message",
71002
+ "documentation_url"
71003
+ ],
71004
+ "properties": {
71005
+ "message": {
71006
+ "type": "string"
71007
+ },
71008
+ "documentation_url": {
71009
+ "type": "string"
71010
+ },
71011
+ "errors": {
71012
+ "type": "array",
71013
+ "items": {
71014
+ "type": "object",
71015
+ "required": [
71016
+ "code"
69879
71017
  ],
69880
- "description": "List of oauth scopes the token has been granted.",
69881
- "items": {
69882
- "type": "string"
71018
+ "properties": {
71019
+ "resource": {
71020
+ "type": "string"
71021
+ },
71022
+ "field": {
71023
+ "type": "string"
71024
+ },
71025
+ "message": {
71026
+ "type": "string"
71027
+ },
71028
+ "code": {
71029
+ "type": "string"
71030
+ },
71031
+ "index": {
71032
+ "type": "integer"
71033
+ },
71034
+ "value": {
71035
+ "oneOf": [
71036
+ {
71037
+ "type": "string",
71038
+ "nullable": true
71039
+ },
71040
+ {
71041
+ "type": "integer",
71042
+ "nullable": true
71043
+ },
71044
+ {
71045
+ "type": "array",
71046
+ "nullable": true,
71047
+ "items": {
71048
+ "type": "string"
71049
+ }
71050
+ }
71051
+ ]
71052
+ }
69883
71053
  }
69884
- },
69885
- "fingerprint": {
69886
- "type": "string",
69887
- "example": "jklmnop12345678",
69888
- "description": "Unique string to distinguish the credential. Only included in responses with credential_type of SSH Key."
69889
- },
69890
- "credential_accessed_at": {
69891
- "type": "string",
69892
- "format": "date-time",
69893
- "example": "2011-01-26T19:06:43Z",
69894
- "description": "Date when the credential was last accessed. May be null if it was never accessed",
69895
- "nullable": true
69896
- },
69897
- "authorized_credential_id": {
69898
- "type": "integer",
69899
- "nullable": true,
69900
- "example": 12345678
69901
- },
69902
- "authorized_credential_title": {
69903
- "type": "string",
69904
- "nullable": true,
69905
- "example": "my ssh key",
69906
- "description": "The title given to the ssh key. This will only be present when the credential is an ssh key."
69907
- },
69908
- "authorized_credential_note": {
69909
- "type": "string",
69910
- "nullable": true,
69911
- "example": "my token",
69912
- "description": "The note given to the token. This will only be present when the credential is a token."
69913
- },
69914
- "authorized_credential_expires_at": {
69915
- "type": "string",
69916
- "format": "date-time",
69917
- "nullable": true,
69918
- "description": "The expiry for the token. This will only be present when the credential is a token."
69919
71054
  }
69920
- },
69921
- "required": [
69922
- "login",
69923
- "credential_id",
69924
- "credential_type",
69925
- "credential_authorized_at",
69926
- "credential_accessed_at",
69927
- "authorized_credential_id"
69928
- ]
69929
- }
69930
- },
69931
- "examples": {
69932
- "default": {
69933
- "value": [
69934
- {
69935
- "login": "octocat",
69936
- "credential_id": 161195,
69937
- "credential_type": "personal access token",
69938
- "token_last_eight": "71c3fc11",
69939
- "credential_authorized_at": "2011-01-26T19:06:43Z",
69940
- "authorized_credential_expires_at": "2011-02-25T19:06:43Z",
69941
- "scopes": [
69942
- "user",
69943
- "repo"
69944
- ]
69945
- },
69946
- {
69947
- "login": "hubot",
69948
- "credential_id": 161196,
69949
- "credential_type": "personal access token",
69950
- "token_last_eight": "Ae178B4a",
69951
- "credential_authorized_at": "2019-03-29T19:06:43Z",
69952
- "authorized_credential_expires_at": "2019-04-28T19:06:43Z",
69953
- "scopes": [
69954
- "repo"
69955
- ]
69956
- }
69957
- ]
71055
+ }
69958
71056
  }
69959
71057
  }
69960
71058
  }
@@ -69962,25 +71060,23 @@
69962
71060
  }
69963
71061
  },
69964
71062
  "x-github": {
69965
- "githubCloudOnly": true,
71063
+ "githubCloudOnly": false,
69966
71064
  "enabledForGitHubApps": true,
69967
71065
  "category": "orgs",
69968
- "subcategory": null
71066
+ "subcategory": "custom-roles"
69969
71067
  },
69970
71068
  "x-octokit": {}
69971
- }
69972
- },
69973
- "/orgs/{org}/credential-authorizations/{credential_id}": {
71069
+ },
69974
71070
  "delete": {
69975
- "summary": "Remove a SAML SSO authorization for an organization",
69976
- "description": "Listing and deleting credential authorizations is available to organizations with GitHub Enterprise Cloud. For more information, see [GitHub's products](https://docs.github.com/github/getting-started-with-github/githubs-products).\n\nAn authenticated organization owner with the `admin:org` scope can remove a credential authorization for an organization that uses SAML SSO. Once you remove someone's credential authorization, they will need to create a new personal access token or SSH key and authorize it for the organization they want to access.",
71071
+ "summary": "Delete a custom role",
71072
+ "description": "**Note**: This operation is in beta and is subject to change.\n\nDeletes a custom role from an organization. Once the custom role has been deleted, any\nuser, team, or invitation with the deleted custom role will be reassigned the inherited role.\n\nTo use this endpoint the authenticated user must be an administrator for the organization and must use an access token with `admin:org` scope.\nGitHub Apps must have the `organization_custom_roles:write` organization permission to use this endpoint.\n\nFor more information about custom repository roles, see \"[Managing custom repository roles for an organization](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-repository-roles-for-an-organization).\"",
69977
71073
  "tags": [
69978
71074
  "orgs"
69979
71075
  ],
69980
- "operationId": "orgs/remove-saml-sso-authorization",
71076
+ "operationId": "orgs/delete-custom-role",
69981
71077
  "externalDocs": {
69982
71078
  "description": "API method documentation",
69983
- "url": "https://docs.github.com/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization"
71079
+ "url": "https://docs.github.com/rest/reference/orgs#delete-a-custom-role"
69984
71080
  },
69985
71081
  "parameters": [
69986
71082
  {
@@ -69993,7 +71089,8 @@
69993
71089
  }
69994
71090
  },
69995
71091
  {
69996
- "name": "credential_id",
71092
+ "name": "role_id",
71093
+ "description": "The unique identifier of the role.",
69997
71094
  "in": "path",
69998
71095
  "required": true,
69999
71096
  "schema": {
@@ -70004,39 +71101,14 @@
70004
71101
  "responses": {
70005
71102
  "204": {
70006
71103
  "description": "Response"
70007
- },
70008
- "404": {
70009
- "description": "Resource not found",
70010
- "content": {
70011
- "application/json": {
70012
- "schema": {
70013
- "title": "Basic Error",
70014
- "description": "Basic Error",
70015
- "type": "object",
70016
- "properties": {
70017
- "message": {
70018
- "type": "string"
70019
- },
70020
- "documentation_url": {
70021
- "type": "string"
70022
- },
70023
- "url": {
70024
- "type": "string"
70025
- },
70026
- "status": {
70027
- "type": "string"
70028
- }
70029
- }
70030
- }
70031
- }
70032
- }
70033
71104
  }
70034
71105
  },
70035
71106
  "x-github": {
70036
- "githubCloudOnly": true,
71107
+ "githubCloudOnly": false,
70037
71108
  "enabledForGitHubApps": true,
71109
+ "previews": [],
70038
71110
  "category": "orgs",
70039
- "subcategory": null
71111
+ "subcategory": "custom-roles"
70040
71112
  },
70041
71113
  "x-octokit": {}
70042
71114
  }
@@ -72072,8 +73144,9 @@
72072
73144
  },
72073
73145
  "use_squash_pr_title_as_default": {
72074
73146
  "type": "boolean",
72075
- "description": "Whether a squash merge commit can use the pull request title as default.",
72076
- "default": false
73147
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
73148
+ "default": false,
73149
+ "deprecated": true
72077
73150
  },
72078
73151
  "squash_merge_commit_title": {
72079
73152
  "type": "string",
@@ -74732,8 +75805,9 @@
74732
75805
  },
74733
75806
  "use_squash_pr_title_as_default": {
74734
75807
  "type": "boolean",
74735
- "description": "Whether a squash merge commit can use the pull request title as default.",
74736
- "default": false
75808
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
75809
+ "default": false,
75810
+ "deprecated": true
74737
75811
  },
74738
75812
  "squash_merge_commit_title": {
74739
75813
  "type": "string",
@@ -76481,6 +77555,86 @@
76481
77555
  "x-octokit": {}
76482
77556
  }
76483
77557
  },
77558
+ "/orgs/{org}/fine_grained_permissions": {
77559
+ "get": {
77560
+ "summary": "List fine-grained permissions for an organization",
77561
+ "description": "**Note**: This operation is in beta and subject to change.\n\nLists the fine-grained permissions available for an organization.\n\nTo use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organizaiton and must use an access token with `admin:org repo` scope.\nGitHub Apps must have the `organization_custom_roles:read` organization permission to use this endpoint.",
77562
+ "tags": [
77563
+ "orgs"
77564
+ ],
77565
+ "operationId": "orgs/list-fine-grained-permissions",
77566
+ "externalDocs": {
77567
+ "description": "API method documentation",
77568
+ "url": "https://docs.github.com/rest/reference/orgs#list-fine-grained-permissions-for-an-organization"
77569
+ },
77570
+ "parameters": [
77571
+ {
77572
+ "name": "org",
77573
+ "description": "The organization name. The name is not case sensitive.",
77574
+ "in": "path",
77575
+ "required": true,
77576
+ "schema": {
77577
+ "type": "string"
77578
+ }
77579
+ }
77580
+ ],
77581
+ "responses": {
77582
+ "200": {
77583
+ "description": "Response",
77584
+ "content": {
77585
+ "application/json": {
77586
+ "schema": {
77587
+ "type": "array",
77588
+ "items": {
77589
+ "title": "Organization Fine-Grained Permission",
77590
+ "description": "Fine-grained permissions available for the organization",
77591
+ "type": "object",
77592
+ "properties": {
77593
+ "name": {
77594
+ "type": "string"
77595
+ },
77596
+ "description": {
77597
+ "type": "string"
77598
+ }
77599
+ },
77600
+ "required": [
77601
+ "name",
77602
+ "description"
77603
+ ]
77604
+ }
77605
+ },
77606
+ "examples": {
77607
+ "default": {
77608
+ "value": [
77609
+ {
77610
+ "name": "add_assignee",
77611
+ "description": "Assign or remove a user"
77612
+ },
77613
+ {
77614
+ "name": "remove_assignee",
77615
+ "description": "Remove an assigned user"
77616
+ },
77617
+ {
77618
+ "name": "add_label",
77619
+ "description": "Add or remove a label"
77620
+ }
77621
+ ]
77622
+ }
77623
+ }
77624
+ }
77625
+ }
77626
+ }
77627
+ },
77628
+ "x-github": {
77629
+ "githubCloudOnly": false,
77630
+ "enabledForGitHubApps": true,
77631
+ "previews": [],
77632
+ "category": "orgs",
77633
+ "subcategory": "custom-roles"
77634
+ },
77635
+ "x-octokit": {}
77636
+ }
77637
+ },
76484
77638
  "/orgs/{org}/hooks": {
76485
77639
  "get": {
76486
77640
  "summary": "List organization webhooks",
@@ -83921,8 +85075,9 @@
83921
85075
  },
83922
85076
  "use_squash_pr_title_as_default": {
83923
85077
  "type": "boolean",
83924
- "description": "Whether a squash merge commit can use the pull request title as default.",
83925
- "default": false
85078
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
85079
+ "default": false,
85080
+ "deprecated": true
83926
85081
  },
83927
85082
  "squash_merge_commit_title": {
83928
85083
  "type": "string",
@@ -87121,8 +88276,9 @@
87121
88276
  },
87122
88277
  "use_squash_pr_title_as_default": {
87123
88278
  "type": "boolean",
87124
- "description": "Whether a squash merge commit can use the pull request title as default.",
87125
- "default": false
88279
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
88280
+ "default": false,
88281
+ "deprecated": true
87126
88282
  },
87127
88283
  "squash_merge_commit_title": {
87128
88284
  "type": "string",
@@ -90170,8 +91326,9 @@
90170
91326
  },
90171
91327
  "use_squash_pr_title_as_default": {
90172
91328
  "type": "boolean",
90173
- "description": "Whether a squash merge commit can use the pull request title as default.",
90174
- "default": false
91329
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
91330
+ "default": false,
91331
+ "deprecated": true
90175
91332
  },
90176
91333
  "squash_merge_commit_title": {
90177
91334
  "type": "string",
@@ -91865,8 +93022,9 @@
91865
93022
  },
91866
93023
  "use_squash_pr_title_as_default": {
91867
93024
  "type": "boolean",
91868
- "description": "Whether a squash merge commit can use the pull request title as default.",
91869
- "default": false
93025
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
93026
+ "default": false,
93027
+ "deprecated": true
91870
93028
  },
91871
93029
  "squash_merge_commit_title": {
91872
93030
  "type": "string",
@@ -93589,8 +94747,9 @@
93589
94747
  },
93590
94748
  "use_squash_pr_title_as_default": {
93591
94749
  "type": "boolean",
93592
- "description": "Whether a squash merge commit can use the pull request title as default.",
93593
- "default": false
94750
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
94751
+ "default": false,
94752
+ "deprecated": true
93594
94753
  },
93595
94754
  "squash_merge_commit_title": {
93596
94755
  "type": "string",
@@ -95745,8 +96904,9 @@
95745
96904
  },
95746
96905
  "use_squash_pr_title_as_default": {
95747
96906
  "type": "boolean",
95748
- "description": "Whether a squash merge commit can use the pull request title as default.",
95749
- "default": false
96907
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
96908
+ "default": false,
96909
+ "deprecated": true
95750
96910
  },
95751
96911
  "squash_merge_commit_title": {
95752
96912
  "type": "string",
@@ -98318,8 +99478,9 @@
98318
99478
  },
98319
99479
  "use_squash_pr_title_as_default": {
98320
99480
  "type": "boolean",
98321
- "description": "Whether a squash merge commit can use the pull request title as default.",
98322
- "default": false
99481
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
99482
+ "default": false,
99483
+ "deprecated": true
98323
99484
  },
98324
99485
  "squash_merge_commit_title": {
98325
99486
  "type": "string",
@@ -100462,8 +101623,9 @@
100462
101623
  },
100463
101624
  "use_squash_pr_title_as_default": {
100464
101625
  "type": "boolean",
100465
- "description": "Whether a squash merge commit can use the pull request title as default.",
100466
- "default": false
101626
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
101627
+ "default": false,
101628
+ "deprecated": true
100467
101629
  },
100468
101630
  "squash_merge_commit_title": {
100469
101631
  "type": "string",
@@ -101113,15 +102275,15 @@
101113
102275
  },
101114
102276
  "/orgs/{org}/packages/{package_type}/{package_name}/versions": {
101115
102277
  "get": {
101116
- "summary": "Get all package versions for a package owned by an organization",
101117
- "description": "Returns all package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
102278
+ "summary": "List package versions for a package owned by an organization",
102279
+ "description": "Lists package versions for a package owned by an organization.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
101118
102280
  "tags": [
101119
102281
  "packages"
101120
102282
  ],
101121
102283
  "operationId": "packages/get-all-package-versions-for-package-owned-by-org",
101122
102284
  "externalDocs": {
101123
102285
  "description": "API method documentation",
101124
- "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-an-organization"
102286
+ "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-an-organization"
101125
102287
  },
101126
102288
  "parameters": [
101127
102289
  {
@@ -104720,8 +105882,9 @@
104720
105882
  },
104721
105883
  "use_squash_pr_title_as_default": {
104722
105884
  "type": "boolean",
104723
- "description": "Whether a squash merge commit can use the pull request title as default.",
104724
- "default": false
105885
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
105886
+ "default": false,
105887
+ "deprecated": true
104725
105888
  },
104726
105889
  "squash_merge_commit_title": {
104727
105890
  "type": "string",
@@ -105260,8 +106423,9 @@
105260
106423
  },
105261
106424
  "use_squash_pr_title_as_default": {
105262
106425
  "type": "boolean",
105263
- "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
105264
- "default": false
106426
+ "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
106427
+ "default": false,
106428
+ "deprecated": true
105265
106429
  },
105266
106430
  "squash_merge_commit_title": {
105267
106431
  "type": "string",
@@ -106364,8 +107528,9 @@
106364
107528
  },
106365
107529
  "use_squash_pr_title_as_default": {
106366
107530
  "type": "boolean",
106367
- "description": "Whether a squash merge commit can use the pull request title as default.",
106368
- "default": false
107531
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
107532
+ "default": false,
107533
+ "deprecated": true
106369
107534
  },
106370
107535
  "squash_merge_commit_title": {
106371
107536
  "type": "string",
@@ -109620,8 +110785,649 @@
109620
110785
  }
109621
110786
  }
109622
110787
  },
109623
- "403": {
109624
- "description": "Forbidden",
110788
+ "403": {
110789
+ "description": "Forbidden",
110790
+ "content": {
110791
+ "application/json": {
110792
+ "schema": {
110793
+ "title": "Basic Error",
110794
+ "description": "Basic Error",
110795
+ "type": "object",
110796
+ "properties": {
110797
+ "message": {
110798
+ "type": "string"
110799
+ },
110800
+ "documentation_url": {
110801
+ "type": "string"
110802
+ },
110803
+ "url": {
110804
+ "type": "string"
110805
+ },
110806
+ "status": {
110807
+ "type": "string"
110808
+ }
110809
+ }
110810
+ }
110811
+ }
110812
+ }
110813
+ },
110814
+ "422": {
110815
+ "description": "Validation failed",
110816
+ "content": {
110817
+ "application/json": {
110818
+ "schema": {
110819
+ "title": "Validation Error",
110820
+ "description": "Validation Error",
110821
+ "type": "object",
110822
+ "required": [
110823
+ "message",
110824
+ "documentation_url"
110825
+ ],
110826
+ "properties": {
110827
+ "message": {
110828
+ "type": "string"
110829
+ },
110830
+ "documentation_url": {
110831
+ "type": "string"
110832
+ },
110833
+ "errors": {
110834
+ "type": "array",
110835
+ "items": {
110836
+ "type": "object",
110837
+ "required": [
110838
+ "code"
110839
+ ],
110840
+ "properties": {
110841
+ "resource": {
110842
+ "type": "string"
110843
+ },
110844
+ "field": {
110845
+ "type": "string"
110846
+ },
110847
+ "message": {
110848
+ "type": "string"
110849
+ },
110850
+ "code": {
110851
+ "type": "string"
110852
+ },
110853
+ "index": {
110854
+ "type": "integer"
110855
+ },
110856
+ "value": {
110857
+ "oneOf": [
110858
+ {
110859
+ "type": "string",
110860
+ "nullable": true
110861
+ },
110862
+ {
110863
+ "type": "integer",
110864
+ "nullable": true
110865
+ },
110866
+ {
110867
+ "type": "array",
110868
+ "nullable": true,
110869
+ "items": {
110870
+ "type": "string"
110871
+ }
110872
+ }
110873
+ ]
110874
+ }
110875
+ }
110876
+ }
110877
+ }
110878
+ }
110879
+ }
110880
+ }
110881
+ }
110882
+ }
110883
+ },
110884
+ "x-github": {
110885
+ "githubCloudOnly": false,
110886
+ "enabledForGitHubApps": true,
110887
+ "category": "teams",
110888
+ "subcategory": null
110889
+ },
110890
+ "x-octokit": {}
110891
+ }
110892
+ },
110893
+ "/orgs/{org}/teams/{team_slug}": {
110894
+ "get": {
110895
+ "summary": "Get a team by name",
110896
+ "description": "Gets a team using the team's `slug`. GitHub generates the `slug` from the team `name`.\n\n**Note:** You can also specify a team by `org_id` and `team_id` using the route `GET /organizations/{org_id}/team/{team_id}`.",
110897
+ "tags": [
110898
+ "teams"
110899
+ ],
110900
+ "operationId": "teams/get-by-name",
110901
+ "externalDocs": {
110902
+ "description": "API method documentation",
110903
+ "url": "https://docs.github.com/rest/reference/teams#get-a-team-by-name"
110904
+ },
110905
+ "parameters": [
110906
+ {
110907
+ "name": "org",
110908
+ "description": "The organization name. The name is not case sensitive.",
110909
+ "in": "path",
110910
+ "required": true,
110911
+ "schema": {
110912
+ "type": "string"
110913
+ }
110914
+ },
110915
+ {
110916
+ "name": "team_slug",
110917
+ "description": "The slug of the team name.",
110918
+ "in": "path",
110919
+ "required": true,
110920
+ "schema": {
110921
+ "type": "string"
110922
+ }
110923
+ }
110924
+ ],
110925
+ "responses": {
110926
+ "200": {
110927
+ "description": "Response",
110928
+ "content": {
110929
+ "application/json": {
110930
+ "schema": {
110931
+ "title": "Full Team",
110932
+ "description": "Groups of organization members that gives permissions on specified repositories.",
110933
+ "type": "object",
110934
+ "properties": {
110935
+ "id": {
110936
+ "description": "Unique identifier of the team",
110937
+ "example": 42,
110938
+ "type": "integer"
110939
+ },
110940
+ "node_id": {
110941
+ "type": "string",
110942
+ "example": "MDQ6VGVhbTE="
110943
+ },
110944
+ "url": {
110945
+ "description": "URL for the team",
110946
+ "example": "https://api.github.com/organizations/1/team/1",
110947
+ "type": "string",
110948
+ "format": "uri"
110949
+ },
110950
+ "html_url": {
110951
+ "type": "string",
110952
+ "format": "uri",
110953
+ "example": "https://github.com/orgs/rails/teams/core"
110954
+ },
110955
+ "name": {
110956
+ "description": "Name of the team",
110957
+ "example": "Developers",
110958
+ "type": "string"
110959
+ },
110960
+ "slug": {
110961
+ "type": "string",
110962
+ "example": "justice-league"
110963
+ },
110964
+ "description": {
110965
+ "type": "string",
110966
+ "example": "A great team.",
110967
+ "nullable": true
110968
+ },
110969
+ "privacy": {
110970
+ "description": "The level of privacy this team should have",
110971
+ "type": "string",
110972
+ "enum": [
110973
+ "closed",
110974
+ "secret"
110975
+ ],
110976
+ "example": "closed"
110977
+ },
110978
+ "permission": {
110979
+ "description": "Permission that the team will have for its repositories",
110980
+ "example": "push",
110981
+ "type": "string"
110982
+ },
110983
+ "members_url": {
110984
+ "type": "string",
110985
+ "example": "https://api.github.com/organizations/1/team/1/members{/member}"
110986
+ },
110987
+ "repositories_url": {
110988
+ "type": "string",
110989
+ "format": "uri",
110990
+ "example": "https://api.github.com/organizations/1/team/1/repos"
110991
+ },
110992
+ "parent": {
110993
+ "title": "Team Simple",
110994
+ "description": "Groups of organization members that gives permissions on specified repositories.",
110995
+ "type": "object",
110996
+ "properties": {
110997
+ "id": {
110998
+ "description": "Unique identifier of the team",
110999
+ "type": "integer",
111000
+ "example": 1
111001
+ },
111002
+ "node_id": {
111003
+ "type": "string",
111004
+ "example": "MDQ6VGVhbTE="
111005
+ },
111006
+ "url": {
111007
+ "description": "URL for the team",
111008
+ "type": "string",
111009
+ "format": "uri",
111010
+ "example": "https://api.github.com/organizations/1/team/1"
111011
+ },
111012
+ "members_url": {
111013
+ "type": "string",
111014
+ "example": "https://api.github.com/organizations/1/team/1/members{/member}"
111015
+ },
111016
+ "name": {
111017
+ "description": "Name of the team",
111018
+ "type": "string",
111019
+ "example": "Justice League"
111020
+ },
111021
+ "description": {
111022
+ "description": "Description of the team",
111023
+ "type": "string",
111024
+ "nullable": true,
111025
+ "example": "A great team."
111026
+ },
111027
+ "permission": {
111028
+ "description": "Permission that the team will have for its repositories",
111029
+ "type": "string",
111030
+ "example": "admin"
111031
+ },
111032
+ "privacy": {
111033
+ "description": "The level of privacy this team should have",
111034
+ "type": "string",
111035
+ "example": "closed"
111036
+ },
111037
+ "html_url": {
111038
+ "type": "string",
111039
+ "format": "uri",
111040
+ "example": "https://github.com/orgs/rails/teams/core"
111041
+ },
111042
+ "repositories_url": {
111043
+ "type": "string",
111044
+ "format": "uri",
111045
+ "example": "https://api.github.com/organizations/1/team/1/repos"
111046
+ },
111047
+ "slug": {
111048
+ "type": "string",
111049
+ "example": "justice-league"
111050
+ },
111051
+ "ldap_dn": {
111052
+ "description": "Distinguished Name (DN) that team maps to within LDAP environment",
111053
+ "example": "uid=example,ou=users,dc=github,dc=com",
111054
+ "type": "string"
111055
+ }
111056
+ },
111057
+ "required": [
111058
+ "id",
111059
+ "node_id",
111060
+ "url",
111061
+ "members_url",
111062
+ "name",
111063
+ "description",
111064
+ "permission",
111065
+ "html_url",
111066
+ "repositories_url",
111067
+ "slug"
111068
+ ],
111069
+ "nullable": true
111070
+ },
111071
+ "members_count": {
111072
+ "type": "integer",
111073
+ "example": 3
111074
+ },
111075
+ "repos_count": {
111076
+ "type": "integer",
111077
+ "example": 10
111078
+ },
111079
+ "created_at": {
111080
+ "type": "string",
111081
+ "format": "date-time",
111082
+ "example": "2017-07-14T16:53:42Z"
111083
+ },
111084
+ "updated_at": {
111085
+ "type": "string",
111086
+ "format": "date-time",
111087
+ "example": "2017-08-17T12:37:15Z"
111088
+ },
111089
+ "organization": {
111090
+ "title": "Team Organization",
111091
+ "description": "Team Organization",
111092
+ "type": "object",
111093
+ "properties": {
111094
+ "login": {
111095
+ "type": "string",
111096
+ "example": "github"
111097
+ },
111098
+ "id": {
111099
+ "type": "integer",
111100
+ "example": 1
111101
+ },
111102
+ "node_id": {
111103
+ "type": "string",
111104
+ "example": "MDEyOk9yZ2FuaXphdGlvbjE="
111105
+ },
111106
+ "url": {
111107
+ "type": "string",
111108
+ "format": "uri",
111109
+ "example": "https://api.github.com/orgs/github"
111110
+ },
111111
+ "repos_url": {
111112
+ "type": "string",
111113
+ "format": "uri",
111114
+ "example": "https://api.github.com/orgs/github/repos"
111115
+ },
111116
+ "events_url": {
111117
+ "type": "string",
111118
+ "format": "uri",
111119
+ "example": "https://api.github.com/orgs/github/events"
111120
+ },
111121
+ "hooks_url": {
111122
+ "type": "string",
111123
+ "example": "https://api.github.com/orgs/github/hooks"
111124
+ },
111125
+ "issues_url": {
111126
+ "type": "string",
111127
+ "example": "https://api.github.com/orgs/github/issues"
111128
+ },
111129
+ "members_url": {
111130
+ "type": "string",
111131
+ "example": "https://api.github.com/orgs/github/members{/member}"
111132
+ },
111133
+ "public_members_url": {
111134
+ "type": "string",
111135
+ "example": "https://api.github.com/orgs/github/public_members{/member}"
111136
+ },
111137
+ "avatar_url": {
111138
+ "type": "string",
111139
+ "example": "https://github.com/images/error/octocat_happy.gif"
111140
+ },
111141
+ "description": {
111142
+ "type": "string",
111143
+ "example": "A great organization",
111144
+ "nullable": true
111145
+ },
111146
+ "name": {
111147
+ "type": "string",
111148
+ "example": "github"
111149
+ },
111150
+ "company": {
111151
+ "type": "string",
111152
+ "example": "GitHub"
111153
+ },
111154
+ "blog": {
111155
+ "type": "string",
111156
+ "format": "uri",
111157
+ "example": "https://github.com/blog"
111158
+ },
111159
+ "location": {
111160
+ "type": "string",
111161
+ "example": "San Francisco"
111162
+ },
111163
+ "email": {
111164
+ "type": "string",
111165
+ "format": "email",
111166
+ "example": "octocat@github.com"
111167
+ },
111168
+ "twitter_username": {
111169
+ "type": "string",
111170
+ "example": "github",
111171
+ "nullable": true
111172
+ },
111173
+ "is_verified": {
111174
+ "type": "boolean",
111175
+ "example": true
111176
+ },
111177
+ "has_organization_projects": {
111178
+ "type": "boolean",
111179
+ "example": true
111180
+ },
111181
+ "has_repository_projects": {
111182
+ "type": "boolean",
111183
+ "example": true
111184
+ },
111185
+ "public_repos": {
111186
+ "type": "integer",
111187
+ "example": 2
111188
+ },
111189
+ "public_gists": {
111190
+ "type": "integer",
111191
+ "example": 1
111192
+ },
111193
+ "followers": {
111194
+ "type": "integer",
111195
+ "example": 20
111196
+ },
111197
+ "following": {
111198
+ "type": "integer",
111199
+ "example": 0
111200
+ },
111201
+ "html_url": {
111202
+ "type": "string",
111203
+ "format": "uri",
111204
+ "example": "https://github.com/octocat"
111205
+ },
111206
+ "created_at": {
111207
+ "type": "string",
111208
+ "format": "date-time",
111209
+ "example": "2008-01-14T04:33:35Z"
111210
+ },
111211
+ "type": {
111212
+ "type": "string",
111213
+ "example": "Organization"
111214
+ },
111215
+ "total_private_repos": {
111216
+ "type": "integer",
111217
+ "example": 100
111218
+ },
111219
+ "owned_private_repos": {
111220
+ "type": "integer",
111221
+ "example": 100
111222
+ },
111223
+ "private_gists": {
111224
+ "type": "integer",
111225
+ "example": 81,
111226
+ "nullable": true
111227
+ },
111228
+ "disk_usage": {
111229
+ "type": "integer",
111230
+ "example": 10000,
111231
+ "nullable": true
111232
+ },
111233
+ "collaborators": {
111234
+ "type": "integer",
111235
+ "example": 8,
111236
+ "nullable": true
111237
+ },
111238
+ "billing_email": {
111239
+ "type": "string",
111240
+ "format": "email",
111241
+ "example": "org@example.com",
111242
+ "nullable": true
111243
+ },
111244
+ "plan": {
111245
+ "type": "object",
111246
+ "properties": {
111247
+ "name": {
111248
+ "type": "string"
111249
+ },
111250
+ "space": {
111251
+ "type": "integer"
111252
+ },
111253
+ "private_repos": {
111254
+ "type": "integer"
111255
+ },
111256
+ "filled_seats": {
111257
+ "type": "integer"
111258
+ },
111259
+ "seats": {
111260
+ "type": "integer"
111261
+ }
111262
+ },
111263
+ "required": [
111264
+ "name",
111265
+ "space",
111266
+ "private_repos"
111267
+ ]
111268
+ },
111269
+ "default_repository_permission": {
111270
+ "type": "string",
111271
+ "nullable": true
111272
+ },
111273
+ "members_can_create_repositories": {
111274
+ "type": "boolean",
111275
+ "example": true,
111276
+ "nullable": true
111277
+ },
111278
+ "two_factor_requirement_enabled": {
111279
+ "type": "boolean",
111280
+ "example": true,
111281
+ "nullable": true
111282
+ },
111283
+ "members_allowed_repository_creation_type": {
111284
+ "type": "string",
111285
+ "example": "all"
111286
+ },
111287
+ "members_can_create_public_repositories": {
111288
+ "type": "boolean",
111289
+ "example": true
111290
+ },
111291
+ "members_can_create_private_repositories": {
111292
+ "type": "boolean",
111293
+ "example": true
111294
+ },
111295
+ "members_can_create_internal_repositories": {
111296
+ "type": "boolean",
111297
+ "example": true
111298
+ },
111299
+ "members_can_create_pages": {
111300
+ "type": "boolean",
111301
+ "example": true
111302
+ },
111303
+ "members_can_create_public_pages": {
111304
+ "type": "boolean",
111305
+ "example": true
111306
+ },
111307
+ "members_can_create_private_pages": {
111308
+ "type": "boolean",
111309
+ "example": true
111310
+ },
111311
+ "members_can_fork_private_repositories": {
111312
+ "type": "boolean",
111313
+ "example": false,
111314
+ "nullable": true
111315
+ },
111316
+ "web_commit_signoff_required": {
111317
+ "type": "boolean",
111318
+ "example": false
111319
+ },
111320
+ "updated_at": {
111321
+ "type": "string",
111322
+ "format": "date-time"
111323
+ }
111324
+ },
111325
+ "required": [
111326
+ "login",
111327
+ "url",
111328
+ "id",
111329
+ "node_id",
111330
+ "repos_url",
111331
+ "events_url",
111332
+ "hooks_url",
111333
+ "issues_url",
111334
+ "members_url",
111335
+ "public_members_url",
111336
+ "avatar_url",
111337
+ "description",
111338
+ "html_url",
111339
+ "has_organization_projects",
111340
+ "has_repository_projects",
111341
+ "public_repos",
111342
+ "public_gists",
111343
+ "followers",
111344
+ "following",
111345
+ "type",
111346
+ "created_at",
111347
+ "updated_at"
111348
+ ]
111349
+ },
111350
+ "ldap_dn": {
111351
+ "description": "Distinguished Name (DN) that team maps to within LDAP environment",
111352
+ "example": "uid=example,ou=users,dc=github,dc=com",
111353
+ "type": "string"
111354
+ }
111355
+ },
111356
+ "required": [
111357
+ "id",
111358
+ "node_id",
111359
+ "url",
111360
+ "members_url",
111361
+ "name",
111362
+ "description",
111363
+ "permission",
111364
+ "html_url",
111365
+ "repositories_url",
111366
+ "slug",
111367
+ "created_at",
111368
+ "updated_at",
111369
+ "members_count",
111370
+ "repos_count",
111371
+ "organization"
111372
+ ]
111373
+ },
111374
+ "examples": {
111375
+ "default": {
111376
+ "value": {
111377
+ "id": 1,
111378
+ "node_id": "MDQ6VGVhbTE=",
111379
+ "url": "https://api.github.com/teams/1",
111380
+ "html_url": "https://github.com/orgs/github/teams/justice-league",
111381
+ "name": "Justice League",
111382
+ "slug": "justice-league",
111383
+ "description": "A great team.",
111384
+ "privacy": "closed",
111385
+ "permission": "admin",
111386
+ "members_url": "https://api.github.com/teams/1/members{/member}",
111387
+ "repositories_url": "https://api.github.com/teams/1/repos",
111388
+ "parent": null,
111389
+ "members_count": 3,
111390
+ "repos_count": 10,
111391
+ "created_at": "2017-07-14T16:53:42Z",
111392
+ "updated_at": "2017-08-17T12:37:15Z",
111393
+ "organization": {
111394
+ "login": "github",
111395
+ "id": 1,
111396
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
111397
+ "url": "https://api.github.com/orgs/github",
111398
+ "repos_url": "https://api.github.com/orgs/github/repos",
111399
+ "events_url": "https://api.github.com/orgs/github/events",
111400
+ "hooks_url": "https://api.github.com/orgs/github/hooks",
111401
+ "issues_url": "https://api.github.com/orgs/github/issues",
111402
+ "members_url": "https://api.github.com/orgs/github/members{/member}",
111403
+ "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
111404
+ "avatar_url": "https://github.com/images/error/octocat_happy.gif",
111405
+ "description": "A great organization",
111406
+ "name": "github",
111407
+ "company": "GitHub",
111408
+ "blog": "https://github.com/blog",
111409
+ "location": "San Francisco",
111410
+ "email": "octocat@github.com",
111411
+ "is_verified": true,
111412
+ "has_organization_projects": true,
111413
+ "has_repository_projects": true,
111414
+ "public_repos": 2,
111415
+ "public_gists": 1,
111416
+ "followers": 20,
111417
+ "following": 0,
111418
+ "html_url": "https://github.com/octocat",
111419
+ "created_at": "2008-01-14T04:33:35Z",
111420
+ "updated_at": "2017-08-17T12:37:15Z",
111421
+ "type": "Organization"
111422
+ }
111423
+ }
111424
+ }
111425
+ }
111426
+ }
111427
+ }
111428
+ },
111429
+ "404": {
111430
+ "description": "Resource not found",
109625
111431
  "content": {
109626
111432
  "application/json": {
109627
111433
  "schema": {
@@ -109645,75 +111451,6 @@
109645
111451
  }
109646
111452
  }
109647
111453
  }
109648
- },
109649
- "422": {
109650
- "description": "Validation failed",
109651
- "content": {
109652
- "application/json": {
109653
- "schema": {
109654
- "title": "Validation Error",
109655
- "description": "Validation Error",
109656
- "type": "object",
109657
- "required": [
109658
- "message",
109659
- "documentation_url"
109660
- ],
109661
- "properties": {
109662
- "message": {
109663
- "type": "string"
109664
- },
109665
- "documentation_url": {
109666
- "type": "string"
109667
- },
109668
- "errors": {
109669
- "type": "array",
109670
- "items": {
109671
- "type": "object",
109672
- "required": [
109673
- "code"
109674
- ],
109675
- "properties": {
109676
- "resource": {
109677
- "type": "string"
109678
- },
109679
- "field": {
109680
- "type": "string"
109681
- },
109682
- "message": {
109683
- "type": "string"
109684
- },
109685
- "code": {
109686
- "type": "string"
109687
- },
109688
- "index": {
109689
- "type": "integer"
109690
- },
109691
- "value": {
109692
- "oneOf": [
109693
- {
109694
- "type": "string",
109695
- "nullable": true
109696
- },
109697
- {
109698
- "type": "integer",
109699
- "nullable": true
109700
- },
109701
- {
109702
- "type": "array",
109703
- "nullable": true,
109704
- "items": {
109705
- "type": "string"
109706
- }
109707
- }
109708
- ]
109709
- }
109710
- }
109711
- }
109712
- }
109713
- }
109714
- }
109715
- }
109716
- }
109717
111454
  }
109718
111455
  },
109719
111456
  "x-github": {
@@ -109723,19 +111460,17 @@
109723
111460
  "subcategory": null
109724
111461
  },
109725
111462
  "x-octokit": {}
109726
- }
109727
- },
109728
- "/orgs/{org}/teams/{team_slug}": {
109729
- "get": {
109730
- "summary": "Get a team by name",
109731
- "description": "Gets a team using the team's `slug`. GitHub generates the `slug` from the team `name`.\n\n**Note:** You can also specify a team by `org_id` and `team_id` using the route `GET /organizations/{org_id}/team/{team_id}`.",
111463
+ },
111464
+ "patch": {
111465
+ "summary": "Update a team",
111466
+ "description": "To edit a team, the authenticated user must either be an organization owner or a team maintainer.\n\n**Note:** You can also specify a team by `org_id` and `team_id` using the route `PATCH /organizations/{org_id}/team/{team_id}`.",
109732
111467
  "tags": [
109733
111468
  "teams"
109734
111469
  ],
109735
- "operationId": "teams/get-by-name",
111470
+ "operationId": "teams/update-in-org",
109736
111471
  "externalDocs": {
109737
111472
  "description": "API method documentation",
109738
- "url": "https://docs.github.com/rest/reference/teams#get-a-team-by-name"
111473
+ "url": "https://docs.github.com/rest/reference/teams#update-a-team"
109739
111474
  },
109740
111475
  "parameters": [
109741
111476
  {
@@ -109757,9 +111492,61 @@
109757
111492
  }
109758
111493
  }
109759
111494
  ],
111495
+ "requestBody": {
111496
+ "required": false,
111497
+ "content": {
111498
+ "application/json": {
111499
+ "schema": {
111500
+ "type": "object",
111501
+ "properties": {
111502
+ "name": {
111503
+ "type": "string",
111504
+ "description": "The name of the team."
111505
+ },
111506
+ "description": {
111507
+ "type": "string",
111508
+ "description": "The description of the team."
111509
+ },
111510
+ "privacy": {
111511
+ "type": "string",
111512
+ "description": "The level of privacy this team should have. Editing teams without specifying this parameter leaves `privacy` intact. When a team is nested, the `privacy` for parent teams cannot be `secret`. The options are: \n**For a non-nested team:** \n\\* `secret` - only visible to organization owners and members of this team. \n\\* `closed` - visible to all members of this organization. \n**For a parent or child team:** \n\\* `closed` - visible to all members of this organization.",
111513
+ "enum": [
111514
+ "secret",
111515
+ "closed"
111516
+ ]
111517
+ },
111518
+ "permission": {
111519
+ "type": "string",
111520
+ "description": "**Deprecated**. The permission that new repositories will be added to the team with when none is specified.",
111521
+ "enum": [
111522
+ "pull",
111523
+ "push",
111524
+ "admin"
111525
+ ],
111526
+ "default": "pull"
111527
+ },
111528
+ "parent_team_id": {
111529
+ "type": "integer",
111530
+ "description": "The ID of a team to set as the parent team.",
111531
+ "nullable": true
111532
+ }
111533
+ }
111534
+ },
111535
+ "examples": {
111536
+ "default": {
111537
+ "value": {
111538
+ "name": "new team name",
111539
+ "description": "new team description",
111540
+ "privacy": "closed"
111541
+ }
111542
+ }
111543
+ }
111544
+ }
111545
+ }
111546
+ },
109760
111547
  "responses": {
109761
111548
  "200": {
109762
- "description": "Response",
111549
+ "description": "Response when the updated information already exists",
109763
111550
  "content": {
109764
111551
  "application/json": {
109765
111552
  "schema": {
@@ -110261,125 +112048,6 @@
110261
112048
  }
110262
112049
  }
110263
112050
  },
110264
- "404": {
110265
- "description": "Resource not found",
110266
- "content": {
110267
- "application/json": {
110268
- "schema": {
110269
- "title": "Basic Error",
110270
- "description": "Basic Error",
110271
- "type": "object",
110272
- "properties": {
110273
- "message": {
110274
- "type": "string"
110275
- },
110276
- "documentation_url": {
110277
- "type": "string"
110278
- },
110279
- "url": {
110280
- "type": "string"
110281
- },
110282
- "status": {
110283
- "type": "string"
110284
- }
110285
- }
110286
- }
110287
- }
110288
- }
110289
- }
110290
- },
110291
- "x-github": {
110292
- "githubCloudOnly": false,
110293
- "enabledForGitHubApps": true,
110294
- "category": "teams",
110295
- "subcategory": null
110296
- },
110297
- "x-octokit": {}
110298
- },
110299
- "patch": {
110300
- "summary": "Update a team",
110301
- "description": "To edit a team, the authenticated user must either be an organization owner or a team maintainer.\n\n**Note:** You can also specify a team by `org_id` and `team_id` using the route `PATCH /organizations/{org_id}/team/{team_id}`.",
110302
- "tags": [
110303
- "teams"
110304
- ],
110305
- "operationId": "teams/update-in-org",
110306
- "externalDocs": {
110307
- "description": "API method documentation",
110308
- "url": "https://docs.github.com/rest/reference/teams#update-a-team"
110309
- },
110310
- "parameters": [
110311
- {
110312
- "name": "org",
110313
- "description": "The organization name. The name is not case sensitive.",
110314
- "in": "path",
110315
- "required": true,
110316
- "schema": {
110317
- "type": "string"
110318
- }
110319
- },
110320
- {
110321
- "name": "team_slug",
110322
- "description": "The slug of the team name.",
110323
- "in": "path",
110324
- "required": true,
110325
- "schema": {
110326
- "type": "string"
110327
- }
110328
- }
110329
- ],
110330
- "requestBody": {
110331
- "required": false,
110332
- "content": {
110333
- "application/json": {
110334
- "schema": {
110335
- "type": "object",
110336
- "properties": {
110337
- "name": {
110338
- "type": "string",
110339
- "description": "The name of the team."
110340
- },
110341
- "description": {
110342
- "type": "string",
110343
- "description": "The description of the team."
110344
- },
110345
- "privacy": {
110346
- "type": "string",
110347
- "description": "The level of privacy this team should have. Editing teams without specifying this parameter leaves `privacy` intact. When a team is nested, the `privacy` for parent teams cannot be `secret`. The options are: \n**For a non-nested team:** \n\\* `secret` - only visible to organization owners and members of this team. \n\\* `closed` - visible to all members of this organization. \n**For a parent or child team:** \n\\* `closed` - visible to all members of this organization.",
110348
- "enum": [
110349
- "secret",
110350
- "closed"
110351
- ]
110352
- },
110353
- "permission": {
110354
- "type": "string",
110355
- "description": "**Deprecated**. The permission that new repositories will be added to the team with when none is specified.",
110356
- "enum": [
110357
- "pull",
110358
- "push",
110359
- "admin"
110360
- ],
110361
- "default": "pull"
110362
- },
110363
- "parent_team_id": {
110364
- "type": "integer",
110365
- "description": "The ID of a team to set as the parent team.",
110366
- "nullable": true
110367
- }
110368
- }
110369
- },
110370
- "examples": {
110371
- "default": {
110372
- "value": {
110373
- "name": "new team name",
110374
- "description": "new team description",
110375
- "privacy": "closed"
110376
- }
110377
- }
110378
- }
110379
- }
110380
- }
110381
- },
110382
- "responses": {
110383
112051
  "201": {
110384
112052
  "description": "Response",
110385
112053
  "content": {
@@ -110882,6 +112550,127 @@
110882
112550
  }
110883
112551
  }
110884
112552
  }
112553
+ },
112554
+ "403": {
112555
+ "description": "Forbidden",
112556
+ "content": {
112557
+ "application/json": {
112558
+ "schema": {
112559
+ "title": "Basic Error",
112560
+ "description": "Basic Error",
112561
+ "type": "object",
112562
+ "properties": {
112563
+ "message": {
112564
+ "type": "string"
112565
+ },
112566
+ "documentation_url": {
112567
+ "type": "string"
112568
+ },
112569
+ "url": {
112570
+ "type": "string"
112571
+ },
112572
+ "status": {
112573
+ "type": "string"
112574
+ }
112575
+ }
112576
+ }
112577
+ }
112578
+ }
112579
+ },
112580
+ "404": {
112581
+ "description": "Resource not found",
112582
+ "content": {
112583
+ "application/json": {
112584
+ "schema": {
112585
+ "title": "Basic Error",
112586
+ "description": "Basic Error",
112587
+ "type": "object",
112588
+ "properties": {
112589
+ "message": {
112590
+ "type": "string"
112591
+ },
112592
+ "documentation_url": {
112593
+ "type": "string"
112594
+ },
112595
+ "url": {
112596
+ "type": "string"
112597
+ },
112598
+ "status": {
112599
+ "type": "string"
112600
+ }
112601
+ }
112602
+ }
112603
+ }
112604
+ }
112605
+ },
112606
+ "422": {
112607
+ "description": "Validation failed",
112608
+ "content": {
112609
+ "application/json": {
112610
+ "schema": {
112611
+ "title": "Validation Error",
112612
+ "description": "Validation Error",
112613
+ "type": "object",
112614
+ "required": [
112615
+ "message",
112616
+ "documentation_url"
112617
+ ],
112618
+ "properties": {
112619
+ "message": {
112620
+ "type": "string"
112621
+ },
112622
+ "documentation_url": {
112623
+ "type": "string"
112624
+ },
112625
+ "errors": {
112626
+ "type": "array",
112627
+ "items": {
112628
+ "type": "object",
112629
+ "required": [
112630
+ "code"
112631
+ ],
112632
+ "properties": {
112633
+ "resource": {
112634
+ "type": "string"
112635
+ },
112636
+ "field": {
112637
+ "type": "string"
112638
+ },
112639
+ "message": {
112640
+ "type": "string"
112641
+ },
112642
+ "code": {
112643
+ "type": "string"
112644
+ },
112645
+ "index": {
112646
+ "type": "integer"
112647
+ },
112648
+ "value": {
112649
+ "oneOf": [
112650
+ {
112651
+ "type": "string",
112652
+ "nullable": true
112653
+ },
112654
+ {
112655
+ "type": "integer",
112656
+ "nullable": true
112657
+ },
112658
+ {
112659
+ "type": "array",
112660
+ "nullable": true,
112661
+ "items": {
112662
+ "type": "string"
112663
+ }
112664
+ }
112665
+ ]
112666
+ }
112667
+ }
112668
+ }
112669
+ }
112670
+ }
112671
+ }
112672
+ }
112673
+ }
110885
112674
  }
110886
112675
  },
110887
112676
  "x-github": {
@@ -119475,8 +121264,9 @@
119475
121264
  },
119476
121265
  "use_squash_pr_title_as_default": {
119477
121266
  "type": "boolean",
119478
- "description": "Whether a squash merge commit can use the pull request title as default.",
119479
- "default": false
121267
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
121268
+ "default": false,
121269
+ "deprecated": true
119480
121270
  },
119481
121271
  "squash_merge_commit_title": {
119482
121272
  "type": "string",
@@ -121525,8 +123315,9 @@
121525
123315
  },
121526
123316
  "use_squash_pr_title_as_default": {
121527
123317
  "type": "boolean",
121528
- "description": "Whether a squash merge commit can use the pull request title as default.",
121529
- "default": false
123318
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
123319
+ "default": false,
123320
+ "deprecated": true
121530
123321
  },
121531
123322
  "squash_merge_commit_title": {
121532
123323
  "type": "string",
@@ -129981,8 +131772,9 @@
129981
131772
  },
129982
131773
  "use_squash_pr_title_as_default": {
129983
131774
  "type": "boolean",
129984
- "description": "Whether a squash merge commit can use the pull request title as default.",
129985
- "default": false
131775
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
131776
+ "default": false,
131777
+ "deprecated": true
129986
131778
  },
129987
131779
  "squash_merge_commit_title": {
129988
131780
  "type": "string",
@@ -131419,8 +133211,9 @@
131419
133211
  },
131420
133212
  "use_squash_pr_title_as_default": {
131421
133213
  "type": "boolean",
131422
- "description": "Whether a squash merge commit can use the pull request title as default.",
131423
- "default": false
133214
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
133215
+ "default": false,
133216
+ "deprecated": true
131424
133217
  },
131425
133218
  "squash_merge_commit_title": {
131426
133219
  "type": "string",
@@ -132612,8 +134405,9 @@
132612
134405
  },
132613
134406
  "use_squash_pr_title_as_default": {
132614
134407
  "type": "boolean",
132615
- "description": "Whether a squash merge commit can use the pull request title as default.",
132616
- "default": false
134408
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
134409
+ "default": false,
134410
+ "deprecated": true
132617
134411
  },
132618
134412
  "squash_merge_commit_title": {
132619
134413
  "type": "string",
@@ -133693,8 +135487,9 @@
133693
135487
  },
133694
135488
  "use_squash_pr_title_as_default": {
133695
135489
  "type": "boolean",
133696
- "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
133697
- "default": false
135490
+ "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
135491
+ "default": false,
135492
+ "deprecated": true
133698
135493
  },
133699
135494
  "squash_merge_commit_title": {
133700
135495
  "type": "string",
@@ -135275,8 +137070,9 @@
135275
137070
  },
135276
137071
  "use_squash_pr_title_as_default": {
135277
137072
  "type": "boolean",
135278
- "description": "Whether a squash merge commit can use the pull request title as default.",
135279
- "default": false
137073
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
137074
+ "default": false,
137075
+ "deprecated": true
135280
137076
  },
135281
137077
  "squash_merge_commit_title": {
135282
137078
  "type": "string",
@@ -136713,8 +138509,9 @@
136713
138509
  },
136714
138510
  "use_squash_pr_title_as_default": {
136715
138511
  "type": "boolean",
136716
- "description": "Whether a squash merge commit can use the pull request title as default.",
136717
- "default": false
138512
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
138513
+ "default": false,
138514
+ "deprecated": true
136718
138515
  },
136719
138516
  "squash_merge_commit_title": {
136720
138517
  "type": "string",
@@ -137906,8 +139703,9 @@
137906
139703
  },
137907
139704
  "use_squash_pr_title_as_default": {
137908
139705
  "type": "boolean",
137909
- "description": "Whether a squash merge commit can use the pull request title as default.",
137910
- "default": false
139706
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
139707
+ "default": false,
139708
+ "deprecated": true
137911
139709
  },
137912
139710
  "squash_merge_commit_title": {
137913
139711
  "type": "string",
@@ -143048,8 +144846,9 @@
143048
144846
  },
143049
144847
  "use_squash_pr_title_as_default": {
143050
144848
  "type": "boolean",
143051
- "description": "Whether a squash merge commit can use the pull request title as default.",
143052
- "default": false
144849
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
144850
+ "default": false,
144851
+ "deprecated": true
143053
144852
  },
143054
144853
  "squash_merge_commit_title": {
143055
144854
  "type": "string",
@@ -144345,8 +146144,9 @@
144345
146144
  },
144346
146145
  "use_squash_pr_title_as_default": {
144347
146146
  "type": "boolean",
144348
- "description": "Whether a squash merge commit can use the pull request title as default.",
144349
- "default": false
146147
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
146148
+ "default": false,
146149
+ "deprecated": true
144350
146150
  },
144351
146151
  "squash_merge_commit_title": {
144352
146152
  "type": "string",
@@ -147868,8 +149668,9 @@
147868
149668
  },
147869
149669
  "use_squash_pr_title_as_default": {
147870
149670
  "type": "boolean",
147871
- "description": "Whether a squash merge commit can use the pull request title as default.",
147872
- "default": false
149671
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
149672
+ "default": false,
149673
+ "deprecated": true
147873
149674
  },
147874
149675
  "squash_merge_commit_title": {
147875
149676
  "type": "string",
@@ -149634,8 +151435,9 @@
149634
151435
  },
149635
151436
  "use_squash_pr_title_as_default": {
149636
151437
  "type": "boolean",
149637
- "description": "Whether a squash merge commit can use the pull request title as default.",
149638
- "default": false
151438
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
151439
+ "default": false,
151440
+ "deprecated": true
149639
151441
  },
149640
151442
  "squash_merge_commit_title": {
149641
151443
  "type": "string",
@@ -152296,8 +154098,9 @@
152296
154098
  },
152297
154099
  "use_squash_pr_title_as_default": {
152298
154100
  "type": "boolean",
152299
- "description": "Whether a squash merge commit can use the pull request title as default.",
152300
- "default": false
154101
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
154102
+ "default": false,
154103
+ "deprecated": true
152301
154104
  },
152302
154105
  "squash_merge_commit_title": {
152303
154106
  "type": "string",
@@ -154062,8 +155865,9 @@
154062
155865
  },
154063
155866
  "use_squash_pr_title_as_default": {
154064
155867
  "type": "boolean",
154065
- "description": "Whether a squash merge commit can use the pull request title as default.",
154066
- "default": false
155868
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
155869
+ "default": false,
155870
+ "deprecated": true
154067
155871
  },
154068
155872
  "squash_merge_commit_title": {
154069
155873
  "type": "string",
@@ -157440,8 +159244,9 @@
157440
159244
  },
157441
159245
  "use_squash_pr_title_as_default": {
157442
159246
  "type": "boolean",
157443
- "description": "Whether a squash merge commit can use the pull request title as default.",
157444
- "default": false
159247
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
159248
+ "default": false,
159249
+ "deprecated": true
157445
159250
  },
157446
159251
  "squash_merge_commit_title": {
157447
159252
  "type": "string",
@@ -159206,8 +161011,9 @@
159206
161011
  },
159207
161012
  "use_squash_pr_title_as_default": {
159208
161013
  "type": "boolean",
159209
- "description": "Whether a squash merge commit can use the pull request title as default.",
159210
- "default": false
161014
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
161015
+ "default": false,
161016
+ "deprecated": true
159211
161017
  },
159212
161018
  "squash_merge_commit_title": {
159213
161019
  "type": "string",
@@ -163571,7 +165377,7 @@
163571
165377
  },
163572
165378
  "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": {
163573
165379
  "get": {
163574
- "summary": "List workflow runs",
165380
+ "summary": "List workflow runs for a workflow",
163575
165381
  "description": "List all workflow runs for a workflow. You can replace `workflow_id` with the workflow file name. For example, you could use `main.yaml`. You can use parameters to narrow the list of results. For more information about using parameters, see [Parameters](https://docs.github.com/rest/overview/resources-in-the-rest-api#parameters).\n\nAnyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope.",
163576
165382
  "tags": [
163577
165383
  "actions"
@@ -165772,8 +167578,9 @@
165772
167578
  },
165773
167579
  "use_squash_pr_title_as_default": {
165774
167580
  "type": "boolean",
165775
- "description": "Whether a squash merge commit can use the pull request title as default.",
165776
- "default": false
167581
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
167582
+ "default": false,
167583
+ "deprecated": true
165777
167584
  },
165778
167585
  "squash_merge_commit_title": {
165779
167586
  "type": "string",
@@ -167538,8 +169345,9 @@
167538
169345
  },
167539
169346
  "use_squash_pr_title_as_default": {
167540
169347
  "type": "boolean",
167541
- "description": "Whether a squash merge commit can use the pull request title as default.",
167542
- "default": false
169348
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
169349
+ "default": false,
169350
+ "deprecated": true
167543
169351
  },
167544
169352
  "squash_merge_commit_title": {
167545
169353
  "type": "string",
@@ -194816,8 +196624,9 @@
194816
196624
  },
194817
196625
  "use_squash_pr_title_as_default": {
194818
196626
  "type": "boolean",
194819
- "description": "Whether a squash merge commit can use the pull request title as default.",
194820
- "default": false
196627
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
196628
+ "default": false,
196629
+ "deprecated": true
194821
196630
  },
194822
196631
  "squash_merge_commit_title": {
194823
196632
  "type": "string",
@@ -197400,8 +199209,9 @@
197400
199209
  },
197401
199210
  "use_squash_pr_title_as_default": {
197402
199211
  "type": "boolean",
197403
- "description": "Whether a squash merge commit can use the pull request title as default.",
197404
- "default": false
199212
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
199213
+ "default": false,
199214
+ "deprecated": true
197405
199215
  },
197406
199216
  "squash_merge_commit_title": {
197407
199217
  "type": "string",
@@ -199701,8 +201511,9 @@
199701
201511
  },
199702
201512
  "use_squash_pr_title_as_default": {
199703
201513
  "type": "boolean",
199704
- "description": "Whether a squash merge commit can use the pull request title as default.",
199705
- "default": false
201514
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
201515
+ "default": false,
201516
+ "deprecated": true
199706
201517
  },
199707
201518
  "squash_merge_commit_title": {
199708
201519
  "type": "string",
@@ -202175,8 +203986,9 @@
202175
203986
  },
202176
203987
  "use_squash_pr_title_as_default": {
202177
203988
  "type": "boolean",
202178
- "description": "Whether a squash merge commit can use the pull request title as default.",
202179
- "default": false
203989
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
203990
+ "default": false,
203991
+ "deprecated": true
202180
203992
  },
202181
203993
  "squash_merge_commit_title": {
202182
203994
  "type": "string",
@@ -209458,8 +211270,9 @@
209458
211270
  },
209459
211271
  "use_squash_pr_title_as_default": {
209460
211272
  "type": "boolean",
209461
- "description": "Whether a squash merge commit can use the pull request title as default.",
209462
- "default": false
211273
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
211274
+ "default": false,
211275
+ "deprecated": true
209463
211276
  },
209464
211277
  "squash_merge_commit_title": {
209465
211278
  "type": "string",
@@ -212265,8 +214078,9 @@
212265
214078
  },
212266
214079
  "use_squash_pr_title_as_default": {
212267
214080
  "type": "boolean",
212268
- "description": "Whether a squash merge commit can use the pull request title as default.",
212269
- "default": false
214081
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
214082
+ "default": false,
214083
+ "deprecated": true
212270
214084
  },
212271
214085
  "squash_merge_commit_title": {
212272
214086
  "type": "string",
@@ -214719,8 +216533,9 @@
214719
216533
  },
214720
216534
  "use_squash_pr_title_as_default": {
214721
216535
  "type": "boolean",
214722
- "description": "Whether a squash merge commit can use the pull request title as default.",
214723
- "default": false
216536
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
216537
+ "default": false,
216538
+ "deprecated": true
214724
216539
  },
214725
216540
  "squash_merge_commit_title": {
214726
216541
  "type": "string",
@@ -216954,6 +218769,22 @@
216954
218769
  "default": "all"
216955
218770
  }
216956
218771
  },
218772
+ {
218773
+ "name": "permission",
218774
+ "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
218775
+ "in": "query",
218776
+ "required": false,
218777
+ "schema": {
218778
+ "type": "string",
218779
+ "enum": [
218780
+ "pull",
218781
+ "triage",
218782
+ "push",
218783
+ "maintain",
218784
+ "admin"
218785
+ ]
218786
+ }
218787
+ },
216957
218788
  {
216958
218789
  "name": "per_page",
216959
218790
  "description": "The number of results per page (max 100).",
@@ -218818,8 +220649,9 @@
218818
220649
  },
218819
220650
  "use_squash_pr_title_as_default": {
218820
220651
  "type": "boolean",
218821
- "description": "Whether a squash merge commit can use the pull request title as default.",
218822
- "default": false
220652
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
220653
+ "default": false,
220654
+ "deprecated": true
218823
220655
  },
218824
220656
  "squash_merge_commit_title": {
218825
220657
  "type": "string",
@@ -226154,8 +227986,9 @@
226154
227986
  },
226155
227987
  "use_squash_pr_title_as_default": {
226156
227988
  "type": "boolean",
226157
- "description": "Whether a squash merge commit can use the pull request title as default.",
226158
- "default": false
227989
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
227990
+ "default": false,
227991
+ "deprecated": true
226159
227992
  },
226160
227993
  "squash_merge_commit_title": {
226161
227994
  "type": "string",
@@ -227488,8 +229321,9 @@
227488
229321
  },
227489
229322
  "use_squash_pr_title_as_default": {
227490
229323
  "type": "boolean",
227491
- "description": "Whether a squash merge commit can use the pull request title as default.",
227492
- "default": false
229324
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
229325
+ "default": false,
229326
+ "deprecated": true
227493
229327
  },
227494
229328
  "squash_merge_commit_title": {
227495
229329
  "type": "string",
@@ -232500,8 +234334,9 @@
232500
234334
  },
232501
234335
  "use_squash_pr_title_as_default": {
232502
234336
  "type": "boolean",
232503
- "description": "Whether a squash merge commit can use the pull request title as default.",
232504
- "default": false
234337
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
234338
+ "default": false,
234339
+ "deprecated": true
232505
234340
  },
232506
234341
  "squash_merge_commit_title": {
232507
234342
  "type": "string",
@@ -234722,8 +236557,9 @@
234722
236557
  },
234723
236558
  "use_squash_pr_title_as_default": {
234724
236559
  "type": "boolean",
234725
- "description": "Whether a squash merge commit can use the pull request title as default.",
234726
- "default": false
236560
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
236561
+ "default": false,
236562
+ "deprecated": true
234727
236563
  },
234728
236564
  "squash_merge_commit_title": {
234729
236565
  "type": "string",
@@ -235875,6 +237711,7 @@
235875
237711
  "description": "The base branch and head branch to compare. This parameter expects the format `{base}...{head}`.",
235876
237712
  "in": "path",
235877
237713
  "required": true,
237714
+ "x-multi-segment": true,
235878
237715
  "schema": {
235879
237716
  "type": "string"
235880
237717
  }
@@ -238652,7 +240489,7 @@
238652
240489
  },
238653
240490
  "put": {
238654
240491
  "summary": "Create or update file contents",
238655
- "description": "Creates a new file or replaces an existing file in a repository.",
240492
+ "description": "Creates a new file or replaces an existing file in a repository. You must authenticate using an access token with the `workflow` scope to use this endpoint.",
238656
240493
  "tags": [
238657
240494
  "repos"
238658
240495
  ],
@@ -239409,7 +241246,7 @@
239409
241246
  },
239410
241247
  "sha": {
239411
241248
  "type": "string",
239412
- "description": "The blob SHA of the file being replaced."
241249
+ "description": "The blob SHA of the file being deleted."
239413
241250
  },
239414
241251
  "branch": {
239415
241252
  "type": "string",
@@ -249933,8 +251770,9 @@
249933
251770
  },
249934
251771
  "use_squash_pr_title_as_default": {
249935
251772
  "type": "boolean",
249936
- "description": "Whether a squash merge commit can use the pull request title as default.",
249937
- "default": false
251773
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
251774
+ "default": false,
251775
+ "deprecated": true
249938
251776
  },
249939
251777
  "squash_merge_commit_title": {
249940
251778
  "type": "string",
@@ -252591,8 +254429,9 @@
252591
254429
  },
252592
254430
  "use_squash_pr_title_as_default": {
252593
254431
  "type": "boolean",
252594
- "description": "Whether a squash merge commit can use the pull request title as default.",
252595
- "default": false
254432
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
254433
+ "default": false,
254434
+ "deprecated": true
252596
254435
  },
252597
254436
  "squash_merge_commit_title": {
252598
254437
  "type": "string",
@@ -254650,8 +256489,9 @@
254650
256489
  },
254651
256490
  "use_squash_pr_title_as_default": {
254652
256491
  "type": "boolean",
254653
- "description": "Whether a squash merge commit can use the pull request title as default.",
254654
- "default": false
256492
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
256493
+ "default": false,
256494
+ "deprecated": true
254655
256495
  },
254656
256496
  "squash_merge_commit_title": {
254657
256497
  "type": "string",
@@ -256088,8 +257928,9 @@
256088
257928
  },
256089
257929
  "use_squash_pr_title_as_default": {
256090
257930
  "type": "boolean",
256091
- "description": "Whether a squash merge commit can use the pull request title as default.",
256092
- "default": false
257931
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
257932
+ "default": false,
257933
+ "deprecated": true
256093
257934
  },
256094
257935
  "squash_merge_commit_title": {
256095
257936
  "type": "string",
@@ -257281,8 +259122,9 @@
257281
259122
  },
257282
259123
  "use_squash_pr_title_as_default": {
257283
259124
  "type": "boolean",
257284
- "description": "Whether a squash merge commit can use the pull request title as default.",
257285
- "default": false
259125
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
259126
+ "default": false,
259127
+ "deprecated": true
257286
259128
  },
257287
259129
  "squash_merge_commit_title": {
257288
259130
  "type": "string",
@@ -261321,7 +263163,7 @@
261321
263163
  "/repos/{owner}/{repo}/git/trees/{tree_sha}": {
261322
263164
  "get": {
261323
263165
  "summary": "Get a tree",
261324
- "description": "Returns a single tree using the SHA1 value for that tree.\n\nIf `truncated` is `true` in the response then the number of items in the `tree` array exceeded our maximum limit. If you need to fetch more items, use the non-recursive method of fetching trees, and fetch one sub-tree at a time.",
263166
+ "description": "Returns a single tree using the SHA1 value for that tree.\n\nIf `truncated` is `true` in the response then the number of items in the `tree` array exceeded our maximum limit. If you need to fetch more items, use the non-recursive method of fetching trees, and fetch one sub-tree at a time.\n\n\n**Note**: The limit for the `tree` array is 100,000 entries with a maximum size of 7 MB when using the `recursive` parameter.",
261325
263167
  "tags": [
261326
263168
  "git"
261327
263169
  ],
@@ -261631,7 +263473,7 @@
261631
263473
  "/repos/{owner}/{repo}/hooks": {
261632
263474
  "get": {
261633
263475
  "summary": "List repository webhooks",
261634
- "description": "",
263476
+ "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
261635
263477
  "tags": [
261636
263478
  "repos"
261637
263479
  ],
@@ -268855,8 +270697,9 @@
268855
270697
  },
268856
270698
  "use_squash_pr_title_as_default": {
268857
270699
  "type": "boolean",
268858
- "description": "Whether a squash merge commit can use the pull request title as default.",
268859
- "default": false
270700
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
270701
+ "default": false,
270702
+ "deprecated": true
268860
270703
  },
268861
270704
  "squash_merge_commit_title": {
268862
270705
  "type": "string",
@@ -271139,8 +272982,9 @@
271139
272982
  },
271140
272983
  "use_squash_pr_title_as_default": {
271141
272984
  "type": "boolean",
271142
- "description": "Whether a squash merge commit can use the pull request title as default.",
271143
- "default": false
272985
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
272986
+ "default": false,
272987
+ "deprecated": true
271144
272988
  },
271145
272989
  "squash_merge_commit_title": {
271146
272990
  "type": "string",
@@ -273992,8 +275836,9 @@
273992
275836
  },
273993
275837
  "use_squash_pr_title_as_default": {
273994
275838
  "type": "boolean",
273995
- "description": "Whether a squash merge commit can use the pull request title as default.",
273996
- "default": false
275839
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
275840
+ "default": false,
275841
+ "deprecated": true
273997
275842
  },
273998
275843
  "squash_merge_commit_title": {
273999
275844
  "type": "string",
@@ -276854,8 +278699,9 @@
276854
278699
  },
276855
278700
  "use_squash_pr_title_as_default": {
276856
278701
  "type": "boolean",
276857
- "description": "Whether a squash merge commit can use the pull request title as default.",
276858
- "default": false
278702
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
278703
+ "default": false,
278704
+ "deprecated": true
276859
278705
  },
276860
278706
  "squash_merge_commit_title": {
276861
278707
  "type": "string",
@@ -282869,8 +284715,9 @@
282869
284715
  },
282870
284716
  "use_squash_pr_title_as_default": {
282871
284717
  "type": "boolean",
282872
- "description": "Whether a squash merge commit can use the pull request title as default.",
282873
- "default": false
284718
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
284719
+ "default": false,
284720
+ "deprecated": true
282874
284721
  },
282875
284722
  "squash_merge_commit_title": {
282876
284723
  "type": "string",
@@ -286787,8 +288634,9 @@
286787
288634
  },
286788
288635
  "use_squash_pr_title_as_default": {
286789
288636
  "type": "boolean",
286790
- "description": "Whether a squash merge commit can use the pull request title as default.",
286791
- "default": false
288637
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
288638
+ "default": false,
288639
+ "deprecated": true
286792
288640
  },
286793
288641
  "squash_merge_commit_title": {
286794
288642
  "type": "string",
@@ -290587,8 +292435,9 @@
290587
292435
  },
290588
292436
  "use_squash_pr_title_as_default": {
290589
292437
  "type": "boolean",
290590
- "description": "Whether a squash merge commit can use the pull request title as default.",
290591
- "default": false
292438
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
292439
+ "default": false,
292440
+ "deprecated": true
290592
292441
  },
290593
292442
  "squash_merge_commit_title": {
290594
292443
  "type": "string",
@@ -293426,8 +295275,9 @@
293426
295275
  },
293427
295276
  "use_squash_pr_title_as_default": {
293428
295277
  "type": "boolean",
293429
- "description": "Whether a squash merge commit can use the pull request title as default.",
293430
- "default": false
295278
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
295279
+ "default": false,
295280
+ "deprecated": true
293431
295281
  },
293432
295282
  "squash_merge_commit_title": {
293433
295283
  "type": "string",
@@ -296291,8 +298141,9 @@
296291
298141
  },
296292
298142
  "use_squash_pr_title_as_default": {
296293
298143
  "type": "boolean",
296294
- "description": "Whether a squash merge commit can use the pull request title as default.",
296295
- "default": false
298144
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
298145
+ "default": false,
298146
+ "deprecated": true
296296
298147
  },
296297
298148
  "squash_merge_commit_title": {
296298
298149
  "type": "string",
@@ -320153,8 +322004,9 @@
320153
322004
  },
320154
322005
  "use_squash_pr_title_as_default": {
320155
322006
  "type": "boolean",
320156
- "description": "Whether a squash merge commit can use the pull request title as default.",
320157
- "default": false
322007
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
322008
+ "default": false,
322009
+ "deprecated": true
320158
322010
  },
320159
322011
  "squash_merge_commit_title": {
320160
322012
  "type": "string",
@@ -329467,8 +331319,9 @@
329467
331319
  },
329468
331320
  "use_squash_pr_title_as_default": {
329469
331321
  "type": "boolean",
329470
- "description": "Whether a squash merge commit can use the pull request title as default.",
329471
- "default": false
331322
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
331323
+ "default": false,
331324
+ "deprecated": true
329472
331325
  },
329473
331326
  "squash_merge_commit_title": {
329474
331327
  "type": "string",
@@ -335753,8 +337606,9 @@
335753
337606
  },
335754
337607
  "use_squash_pr_title_as_default": {
335755
337608
  "type": "boolean",
335756
- "description": "Whether a squash merge commit can use the pull request title as default.",
335757
- "default": false
337609
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
337610
+ "default": false,
337611
+ "deprecated": true
335758
337612
  },
335759
337613
  "squash_merge_commit_title": {
335760
337614
  "type": "string",
@@ -337087,8 +338941,9 @@
337087
338941
  },
337088
338942
  "use_squash_pr_title_as_default": {
337089
338943
  "type": "boolean",
337090
- "description": "Whether a squash merge commit can use the pull request title as default.",
337091
- "default": false
338944
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
338945
+ "default": false,
338946
+ "deprecated": true
337092
338947
  },
337093
338948
  "squash_merge_commit_title": {
337094
338949
  "type": "string",
@@ -353006,8 +354861,9 @@
353006
354861
  },
353007
354862
  "use_squash_pr_title_as_default": {
353008
354863
  "type": "boolean",
353009
- "description": "Whether a squash merge commit can use the pull request title as default.",
353010
- "default": false
354864
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
354865
+ "default": false,
354866
+ "deprecated": true
353011
354867
  },
353012
354868
  "squash_merge_commit_title": {
353013
354869
  "type": "string",
@@ -355460,8 +357316,9 @@
355460
357316
  },
355461
357317
  "use_squash_pr_title_as_default": {
355462
357318
  "type": "boolean",
355463
- "description": "Whether a squash merge commit can use the pull request title as default.",
355464
- "default": false
357319
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
357320
+ "default": false,
357321
+ "deprecated": true
355465
357322
  },
355466
357323
  "squash_merge_commit_title": {
355467
357324
  "type": "string",
@@ -362029,8 +363886,9 @@
362029
363886
  },
362030
363887
  "use_squash_pr_title_as_default": {
362031
363888
  "type": "boolean",
362032
- "description": "Whether a squash merge commit can use the pull request title as default.",
362033
- "default": false
363889
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
363890
+ "default": false,
363891
+ "deprecated": true
362034
363892
  },
362035
363893
  "squash_merge_commit_title": {
362036
363894
  "type": "string",
@@ -363363,8 +365221,9 @@
363363
365221
  },
363364
365222
  "use_squash_pr_title_as_default": {
363365
365223
  "type": "boolean",
363366
- "description": "Whether a squash merge commit can use the pull request title as default.",
363367
- "default": false
365224
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
365225
+ "default": false,
365226
+ "deprecated": true
363368
365227
  },
363369
365228
  "squash_merge_commit_title": {
363370
365229
  "type": "string",
@@ -366746,8 +368605,9 @@
366746
368605
  },
366747
368606
  "use_squash_pr_title_as_default": {
366748
368607
  "type": "boolean",
366749
- "description": "Whether a squash merge commit can use the pull request title as default.",
366750
- "default": false
368608
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
368609
+ "default": false,
368610
+ "deprecated": true
366751
368611
  },
366752
368612
  "squash_merge_commit_title": {
366753
368613
  "type": "string",
@@ -368080,8 +369940,9 @@
368080
369940
  },
368081
369941
  "use_squash_pr_title_as_default": {
368082
369942
  "type": "boolean",
368083
- "description": "Whether a squash merge commit can use the pull request title as default.",
368084
- "default": false
369943
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
369944
+ "default": false,
369945
+ "deprecated": true
368085
369946
  },
368086
369947
  "squash_merge_commit_title": {
368087
369948
  "type": "string",
@@ -387213,8 +389074,9 @@
387213
389074
  },
387214
389075
  "use_squash_pr_title_as_default": {
387215
389076
  "type": "boolean",
387216
- "description": "Whether a squash merge commit can use the pull request title as default.",
387217
- "default": false
389077
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
389078
+ "default": false,
389079
+ "deprecated": true
387218
389080
  },
387219
389081
  "squash_merge_commit_title": {
387220
389082
  "type": "string",
@@ -389079,8 +390941,9 @@
389079
390941
  },
389080
390942
  "use_squash_pr_title_as_default": {
389081
390943
  "type": "boolean",
389082
- "description": "Whether a squash merge commit can use the pull request title as default.",
389083
- "default": false
390944
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
390945
+ "default": false,
390946
+ "deprecated": true
389084
390947
  },
389085
390948
  "squash_merge_commit_title": {
389086
390949
  "type": "string",
@@ -390878,8 +392741,9 @@
390878
392741
  },
390879
392742
  "use_squash_pr_title_as_default": {
390880
392743
  "type": "boolean",
390881
- "description": "Whether a squash merge commit can use the pull request title as default.",
390882
- "default": false
392744
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
392745
+ "default": false,
392746
+ "deprecated": true
390883
392747
  },
390884
392748
  "squash_merge_commit_title": {
390885
392749
  "type": "string",
@@ -398866,8 +400730,9 @@
398866
400730
  },
398867
400731
  "use_squash_pr_title_as_default": {
398868
400732
  "type": "boolean",
398869
- "description": "Whether a squash merge commit can use the pull request title as default.",
398870
- "default": false
400733
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
400734
+ "default": false,
400735
+ "deprecated": true
398871
400736
  },
398872
400737
  "squash_merge_commit_title": {
398873
400738
  "type": "string",
@@ -401299,8 +403164,9 @@
401299
403164
  },
401300
403165
  "use_squash_pr_title_as_default": {
401301
403166
  "type": "boolean",
401302
- "description": "Whether a squash merge commit can use the pull request title as default.",
401303
- "default": false
403167
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
403168
+ "default": false,
403169
+ "deprecated": true
401304
403170
  },
401305
403171
  "squash_merge_commit_title": {
401306
403172
  "type": "string",
@@ -403727,8 +405593,9 @@
403727
405593
  },
403728
405594
  "use_squash_pr_title_as_default": {
403729
405595
  "type": "boolean",
403730
- "description": "Whether a squash merge commit can use the pull request title as default.",
403731
- "default": false
405596
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
405597
+ "default": false,
405598
+ "deprecated": true
403732
405599
  },
403733
405600
  "squash_merge_commit_title": {
403734
405601
  "type": "string",
@@ -416300,8 +418167,9 @@
416300
418167
  },
416301
418168
  "use_squash_pr_title_as_default": {
416302
418169
  "type": "boolean",
416303
- "description": "Whether a squash merge commit can use the pull request title as default.",
416304
- "default": false
418170
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
418171
+ "default": false,
418172
+ "deprecated": true
416305
418173
  },
416306
418174
  "squash_merge_commit_title": {
416307
418175
  "type": "string",
@@ -418370,8 +420238,9 @@
418370
420238
  },
418371
420239
  "use_squash_pr_title_as_default": {
418372
420240
  "type": "boolean",
418373
- "description": "Whether a squash merge commit can use the pull request title as default.",
418374
- "default": false
420241
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
420242
+ "default": false,
420243
+ "deprecated": true
418375
420244
  },
418376
420245
  "squash_merge_commit_title": {
418377
420246
  "type": "string",
@@ -423649,8 +425518,9 @@
423649
425518
  },
423650
425519
  "use_squash_pr_title_as_default": {
423651
425520
  "type": "boolean",
423652
- "description": "Whether a squash merge commit can use the pull request title as default.",
423653
- "default": false
425521
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
425522
+ "default": false,
425523
+ "deprecated": true
423654
425524
  },
423655
425525
  "squash_merge_commit_title": {
423656
425526
  "type": "string",
@@ -426639,8 +428509,9 @@
426639
428509
  },
426640
428510
  "use_squash_pr_title_as_default": {
426641
428511
  "type": "boolean",
426642
- "description": "Whether a squash merge commit can use the pull request title as default.",
426643
- "default": false
428512
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
428513
+ "default": false,
428514
+ "deprecated": true
426644
428515
  },
426645
428516
  "squash_merge_commit_title": {
426646
428517
  "type": "string",
@@ -429093,8 +430964,9 @@
429093
430964
  },
429094
430965
  "use_squash_pr_title_as_default": {
429095
430966
  "type": "boolean",
429096
- "description": "Whether a squash merge commit can use the pull request title as default.",
429097
- "default": false
430967
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
430968
+ "default": false,
430969
+ "deprecated": true
429098
430970
  },
429099
430971
  "squash_merge_commit_title": {
429100
430972
  "type": "string",
@@ -431920,8 +433792,9 @@
431920
433792
  },
431921
433793
  "use_squash_pr_title_as_default": {
431922
433794
  "type": "boolean",
431923
- "description": "Whether a squash merge commit can use the pull request title as default.",
431924
- "default": false
433795
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
433796
+ "default": false,
433797
+ "deprecated": true
431925
433798
  },
431926
433799
  "squash_merge_commit_title": {
431927
433800
  "type": "string",
@@ -434815,8 +436688,9 @@
434815
436688
  },
434816
436689
  "use_squash_pr_title_as_default": {
434817
436690
  "type": "boolean",
434818
- "description": "Whether a squash merge commit can use the pull request title as default.",
434819
- "default": false
436691
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
436692
+ "default": false,
436693
+ "deprecated": true
434820
436694
  },
434821
436695
  "squash_merge_commit_title": {
434822
436696
  "type": "string",
@@ -437442,8 +439316,9 @@
437442
439316
  },
437443
439317
  "use_squash_pr_title_as_default": {
437444
439318
  "type": "boolean",
437445
- "description": "Whether a squash merge commit can use the pull request title as default.",
437446
- "default": false
439319
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
439320
+ "default": false,
439321
+ "deprecated": true
437447
439322
  },
437448
439323
  "squash_merge_commit_title": {
437449
439324
  "type": "string",
@@ -440804,8 +442679,9 @@
440804
442679
  },
440805
442680
  "use_squash_pr_title_as_default": {
440806
442681
  "type": "boolean",
440807
- "description": "Whether a squash merge commit can use the pull request title as default.",
440808
- "default": false
442682
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
442683
+ "default": false,
442684
+ "deprecated": true
440809
442685
  },
440810
442686
  "squash_merge_commit_title": {
440811
442687
  "type": "string",
@@ -443511,8 +445387,9 @@
443511
445387
  },
443512
445388
  "use_squash_pr_title_as_default": {
443513
445389
  "type": "boolean",
443514
- "description": "Whether a squash merge commit can use the pull request title as default.",
443515
- "default": false
445390
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
445391
+ "default": false,
445392
+ "deprecated": true
443516
445393
  },
443517
445394
  "squash_merge_commit_title": {
443518
445395
  "type": "string",
@@ -449554,8 +451431,9 @@
449554
451431
  },
449555
451432
  "use_squash_pr_title_as_default": {
449556
451433
  "type": "boolean",
449557
- "description": "Whether a squash merge commit can use the pull request title as default.",
449558
- "default": false
451434
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
451435
+ "default": false,
451436
+ "deprecated": true
449559
451437
  },
449560
451438
  "squash_merge_commit_title": {
449561
451439
  "type": "string",
@@ -452512,8 +454390,9 @@
452512
454390
  },
452513
454391
  "use_squash_pr_title_as_default": {
452514
454392
  "type": "boolean",
452515
- "description": "Whether a squash merge commit can use the pull request title as default.",
452516
- "default": false
454393
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
454394
+ "default": false,
454395
+ "deprecated": true
452517
454396
  },
452518
454397
  "squash_merge_commit_title": {
452519
454398
  "type": "string",
@@ -457366,8 +459245,9 @@
457366
459245
  },
457367
459246
  "use_squash_pr_title_as_default": {
457368
459247
  "type": "boolean",
457369
- "description": "Whether a squash merge commit can use the pull request title as default.",
457370
- "default": false
459248
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
459249
+ "default": false,
459250
+ "deprecated": true
457371
459251
  },
457372
459252
  "squash_merge_commit_title": {
457373
459253
  "type": "string",
@@ -459115,8 +460995,9 @@
459115
460995
  },
459116
460996
  "use_squash_pr_title_as_default": {
459117
460997
  "type": "boolean",
459118
- "description": "Whether a squash merge commit can use the pull request title as default.",
459119
- "default": false
460998
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
460999
+ "default": false,
461000
+ "deprecated": true
459120
461001
  },
459121
461002
  "squash_merge_commit_title": {
459122
461003
  "type": "string",
@@ -460854,8 +462735,9 @@
460854
462735
  },
460855
462736
  "use_squash_pr_title_as_default": {
460856
462737
  "type": "boolean",
460857
- "description": "Whether a squash merge commit can use the pull request title as default.",
460858
- "default": false
462738
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
462739
+ "default": false,
462740
+ "deprecated": true
460859
462741
  },
460860
462742
  "squash_merge_commit_title": {
460861
462743
  "type": "string",
@@ -463169,8 +465051,9 @@
463169
465051
  },
463170
465052
  "use_squash_pr_title_as_default": {
463171
465053
  "type": "boolean",
463172
- "description": "Whether a squash merge commit can use the pull request title as default.",
463173
- "default": false
465054
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
465055
+ "default": false,
465056
+ "deprecated": true
463174
465057
  },
463175
465058
  "squash_merge_commit_title": {
463176
465059
  "type": "string",
@@ -465532,8 +467415,9 @@
465532
467415
  },
465533
467416
  "use_squash_pr_title_as_default": {
465534
467417
  "type": "boolean",
465535
- "description": "Whether a squash merge commit can use the pull request title as default.",
465536
- "default": false
467418
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
467419
+ "default": false,
467420
+ "deprecated": true
465537
467421
  },
465538
467422
  "squash_merge_commit_title": {
465539
467423
  "type": "string",
@@ -467615,8 +469499,9 @@
467615
469499
  },
467616
469500
  "use_squash_pr_title_as_default": {
467617
469501
  "type": "boolean",
467618
- "description": "Whether a squash merge commit can use the pull request title as default.",
467619
- "default": false
469502
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
469503
+ "default": false,
469504
+ "deprecated": true
467620
469505
  },
467621
469506
  "squash_merge_commit_title": {
467622
469507
  "type": "string",
@@ -468315,15 +470200,15 @@
468315
470200
  },
468316
470201
  "/user/packages/{package_type}/{package_name}/versions": {
468317
470202
  "get": {
468318
- "summary": "Get all package versions for a package owned by the authenticated user",
468319
- "description": "Returns all package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
470203
+ "summary": "List package versions for a package owned by the authenticated user",
470204
+ "description": "Lists package versions for a package owned by the authenticated user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
468320
470205
  "tags": [
468321
470206
  "packages"
468322
470207
  ],
468323
470208
  "operationId": "packages/get-all-package-versions-for-package-owned-by-authenticated-user",
468324
470209
  "externalDocs": {
468325
470210
  "description": "API method documentation",
468326
- "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
470211
+ "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-the-authenticated-user"
468327
470212
  },
468328
470213
  "parameters": [
468329
470214
  {
@@ -470889,8 +472774,9 @@
470889
472774
  },
470890
472775
  "use_squash_pr_title_as_default": {
470891
472776
  "type": "boolean",
470892
- "description": "Whether a squash merge commit can use the pull request title as default.",
470893
- "default": false
472777
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
472778
+ "default": false,
472779
+ "deprecated": true
470894
472780
  },
470895
472781
  "squash_merge_commit_title": {
470896
472782
  "type": "string",
@@ -472512,8 +474398,9 @@
472512
474398
  },
472513
474399
  "use_squash_pr_title_as_default": {
472514
474400
  "type": "boolean",
472515
- "description": "Whether a squash merge commit can use the pull request title as default.",
472516
- "default": false
474401
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
474402
+ "default": false,
474403
+ "deprecated": true
472517
474404
  },
472518
474405
  "squash_merge_commit_title": {
472519
474406
  "type": "string",
@@ -474548,8 +476435,9 @@
474548
476435
  },
474549
476436
  "use_squash_pr_title_as_default": {
474550
476437
  "type": "boolean",
474551
- "description": "Whether a squash merge commit can use the pull request title as default.",
474552
- "default": false
476438
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
476439
+ "default": false,
476440
+ "deprecated": true
474553
476441
  },
474554
476442
  "squash_merge_commit_title": {
474555
476443
  "type": "string",
@@ -475818,7 +477706,7 @@
475818
477706
  "key": {
475819
477707
  "description": "The public SSH key to add to your GitHub account. For more information, see \"[Checking for existing SSH keys](https://docs.github.com/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys).\"",
475820
477708
  "type": "string",
475821
- "pattern": "^ssh-(rsa|dss|ed25519) |^ecdsa-sha2-nistp(256|384|521) "
477709
+ "pattern": "^ssh-(rsa|dss|ed25519) |^ecdsa-sha2-nistp(256|384|521) |^(sk-ssh-ed25519|sk-ecdsa-sha2-nistp256)@openssh.com "
475822
477710
  }
475823
477711
  },
475824
477712
  "required": [
@@ -477417,8 +479305,9 @@
477417
479305
  },
477418
479306
  "use_squash_pr_title_as_default": {
477419
479307
  "type": "boolean",
477420
- "description": "Whether a squash merge commit can use the pull request title as default.",
477421
- "default": false
479308
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
479309
+ "default": false,
479310
+ "deprecated": true
477422
479311
  },
477423
479312
  "squash_merge_commit_title": {
477424
479313
  "type": "string",
@@ -478754,8 +480643,9 @@
478754
480643
  },
478755
480644
  "use_squash_pr_title_as_default": {
478756
480645
  "type": "boolean",
478757
- "description": "Whether a squash merge commit can use the pull request title as default.",
478758
- "default": false
480646
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
480647
+ "default": false,
480648
+ "deprecated": true
478759
480649
  },
478760
480650
  "squash_merge_commit_title": {
478761
480651
  "type": "string",
@@ -481014,8 +482904,9 @@
481014
482904
  },
481015
482905
  "use_squash_pr_title_as_default": {
481016
482906
  "type": "boolean",
481017
- "description": "Whether a squash merge commit can use the pull request title as default.",
481018
- "default": false
482907
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
482908
+ "default": false,
482909
+ "deprecated": true
481019
482910
  },
481020
482911
  "squash_merge_commit_title": {
481021
482912
  "type": "string",
@@ -485011,8 +486902,9 @@
485011
486902
  },
485012
486903
  "use_squash_pr_title_as_default": {
485013
486904
  "type": "boolean",
485014
- "description": "Whether a squash merge commit can use the pull request title as default.",
485015
- "default": false
486905
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
486906
+ "default": false,
486907
+ "deprecated": true
485016
486908
  },
485017
486909
  "squash_merge_commit_title": {
485018
486910
  "type": "string",
@@ -488218,8 +490110,9 @@
488218
490110
  },
488219
490111
  "use_squash_pr_title_as_default": {
488220
490112
  "type": "boolean",
488221
- "description": "Whether a squash merge commit can use the pull request title as default.",
488222
- "default": false
490113
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
490114
+ "default": false,
490115
+ "deprecated": true
488223
490116
  },
488224
490117
  "squash_merge_commit_title": {
488225
490118
  "type": "string",
@@ -491427,8 +493320,9 @@
491427
493320
  },
491428
493321
  "use_squash_pr_title_as_default": {
491429
493322
  "type": "boolean",
491430
- "description": "Whether a squash merge commit can use the pull request title as default.",
491431
- "default": false
493323
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
493324
+ "default": false,
493325
+ "deprecated": true
491432
493326
  },
491433
493327
  "squash_merge_commit_title": {
491434
493328
  "type": "string",
@@ -496793,8 +498687,9 @@
496793
498687
  },
496794
498688
  "use_squash_pr_title_as_default": {
496795
498689
  "type": "boolean",
496796
- "description": "Whether a squash merge commit can use the pull request title as default.",
496797
- "default": false
498690
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
498691
+ "default": false,
498692
+ "deprecated": true
496798
498693
  },
496799
498694
  "squash_merge_commit_title": {
496800
498695
  "type": "string",
@@ -498937,8 +500832,9 @@
498937
500832
  },
498938
500833
  "use_squash_pr_title_as_default": {
498939
500834
  "type": "boolean",
498940
- "description": "Whether a squash merge commit can use the pull request title as default.",
498941
- "default": false
500835
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
500836
+ "default": false,
500837
+ "deprecated": true
498942
500838
  },
498943
500839
  "squash_merge_commit_title": {
498944
500840
  "type": "string",
@@ -499655,15 +501551,15 @@
499655
501551
  },
499656
501552
  "/users/{username}/packages/{package_type}/{package_name}/versions": {
499657
501553
  "get": {
499658
- "summary": "Get all package versions for a package owned by a user",
499659
- "description": "Returns all package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
501554
+ "summary": "List package versions for a package owned by a user",
501555
+ "description": "Lists package versions for a public package owned by a specified user.\n\nTo use this endpoint, you must authenticate using an access token with the `packages:read` scope.\nIf `package_type` is not `container`, your token must also include the `repo` scope.",
499660
501556
  "tags": [
499661
501557
  "packages"
499662
501558
  ],
499663
501559
  "operationId": "packages/get-all-package-versions-for-package-owned-by-user",
499664
501560
  "externalDocs": {
499665
501561
  "description": "API method documentation",
499666
- "url": "https://docs.github.com/rest/reference/packages#get-all-package-versions-for-a-package-owned-by-a-user"
501562
+ "url": "https://docs.github.com/rest/packages#get-all-package-versions-for-a-package-owned-by-a-user"
499667
501563
  },
499668
501564
  "parameters": [
499669
501565
  {
@@ -502957,8 +504853,9 @@
502957
504853
  },
502958
504854
  "use_squash_pr_title_as_default": {
502959
504855
  "type": "boolean",
502960
- "description": "Whether a squash merge commit can use the pull request title as default.",
502961
- "default": false
504856
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
504857
+ "default": false,
504858
+ "deprecated": true
502962
504859
  },
502963
504860
  "squash_merge_commit_title": {
502964
504861
  "type": "string",
@@ -506166,8 +508063,9 @@
506166
508063
  },
506167
508064
  "use_squash_pr_title_as_default": {
506168
508065
  "type": "boolean",
506169
- "description": "Whether a squash merge commit can use the pull request title as default.",
506170
- "default": false
508066
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
508067
+ "default": false,
508068
+ "deprecated": true
506171
508069
  },
506172
508070
  "squash_merge_commit_title": {
506173
508071
  "type": "string",
@@ -508854,8 +510752,9 @@
508854
510752
  },
508855
510753
  "use_squash_pr_title_as_default": {
508856
510754
  "type": "boolean",
508857
- "description": "Whether a squash merge commit can use the pull request title as default.",
508858
- "default": false
510755
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
510756
+ "default": false,
510757
+ "deprecated": true
508859
510758
  },
508860
510759
  "squash_merge_commit_title": {
508861
510760
  "type": "string",
@@ -510803,8 +512702,9 @@
510803
512702
  },
510804
512703
  "use_squash_pr_title_as_default": {
510805
512704
  "type": "boolean",
510806
- "description": "Whether a squash merge commit can use the pull request title as default.",
510807
- "default": false
512705
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
512706
+ "default": false,
512707
+ "deprecated": true
510808
512708
  },
510809
512709
  "squash_merge_commit_title": {
510810
512710
  "type": "string",
@@ -512005,8 +513905,9 @@
512005
513905
  },
512006
513906
  "use_squash_pr_title_as_default": {
512007
513907
  "type": "boolean",
512008
- "description": "Whether a squash merge commit can use the pull request title as default.",
512009
- "default": false
513908
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
513909
+ "default": false,
513910
+ "deprecated": true
512010
513911
  },
512011
513912
  "squash_merge_commit_title": {
512012
513913
  "type": "string",
@@ -513835,8 +515736,9 @@
513835
515736
  },
513836
515737
  "use_squash_pr_title_as_default": {
513837
515738
  "type": "boolean",
513838
- "description": "Whether a squash merge commit can use the pull request title as default.",
513839
- "default": false
515739
+ "description": "Whether a squash merge commit can use the pull request title as default. **This property has been deprecated. Please use `squash_merge_commit_title` instead.",
515740
+ "default": false,
515741
+ "deprecated": true
513840
515742
  },
513841
515743
  "squash_merge_commit_title": {
513842
515744
  "type": "string",