@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": {
@@ -86628,8 +86628,9 @@
86628
86628
  },
86629
86629
  "use_squash_pr_title_as_default": {
86630
86630
  "type": "boolean",
86631
- "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
86632
- "default": false
86631
+ "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.",
86632
+ "default": false,
86633
+ "deprecated": true
86633
86634
  },
86634
86635
  "squash_merge_commit_title": {
86635
86636
  "type": "string",
@@ -90493,131 +90494,624 @@
90493
90494
  }
90494
90495
  }
90495
90496
  },
90496
- "404": {
90497
- "description": "Resource not found",
90498
- "content": {
90499
- "application/json": {
90500
- "schema": {
90501
- "title": "Basic Error",
90502
- "description": "Basic Error",
90503
- "type": "object",
90504
- "properties": {
90505
- "message": {
90506
- "type": "string"
90507
- },
90508
- "documentation_url": {
90509
- "type": "string"
90510
- },
90511
- "url": {
90512
- "type": "string"
90513
- },
90514
- "status": {
90515
- "type": "string"
90516
- }
90517
- }
90518
- }
90519
- }
90520
- }
90521
- }
90522
- },
90523
- "x-github": {
90524
- "githubCloudOnly": false,
90525
- "enabledForGitHubApps": true,
90526
- "category": "teams",
90527
- "subcategory": null
90528
- },
90529
- "x-octokit": {
90530
- "diff": {
90531
- "ghes-3.4": {
90532
- "type": "changed"
90533
- }
90534
- }
90535
- }
90536
- },
90537
- "patch": {
90538
- "summary": "Update a team",
90539
- "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}`.",
90540
- "tags": [
90541
- "teams"
90542
- ],
90543
- "operationId": "teams/update-in-org",
90544
- "externalDocs": {
90545
- "description": "API method documentation",
90546
- "url": "https://docs.github.com/enterprise-server@3.3/rest/reference/teams#update-a-team"
90547
- },
90548
- "parameters": [
90549
- {
90550
- "name": "org",
90551
- "description": "The organization name. The name is not case sensitive.",
90552
- "in": "path",
90553
- "required": true,
90554
- "schema": {
90555
- "type": "string"
90556
- }
90557
- },
90558
- {
90559
- "name": "team_slug",
90560
- "description": "The slug of the team name.",
90561
- "in": "path",
90562
- "required": true,
90563
- "schema": {
90564
- "type": "string"
90565
- }
90566
- }
90567
- ],
90568
- "requestBody": {
90569
- "required": false,
90570
- "content": {
90571
- "application/json": {
90572
- "schema": {
90573
- "type": "object",
90574
- "properties": {
90575
- "name": {
90576
- "type": "string",
90577
- "description": "The name of the team."
90578
- },
90579
- "description": {
90580
- "type": "string",
90581
- "description": "The description of the team."
90582
- },
90583
- "privacy": {
90584
- "type": "string",
90585
- "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.",
90586
- "enum": [
90587
- "secret",
90588
- "closed"
90589
- ]
90590
- },
90591
- "permission": {
90592
- "type": "string",
90593
- "description": "**Deprecated**. The permission that new repositories will be added to the team with when none is specified.",
90594
- "enum": [
90595
- "pull",
90596
- "push",
90597
- "admin"
90598
- ],
90599
- "default": "pull"
90600
- },
90601
- "parent_team_id": {
90602
- "type": "integer",
90603
- "description": "The ID of a team to set as the parent team.",
90604
- "nullable": true
90605
- }
90606
- }
90607
- },
90608
- "examples": {
90609
- "default": {
90610
- "value": {
90611
- "name": "new team name",
90612
- "description": "new team description",
90613
- "privacy": "closed"
90614
- }
90615
- }
90616
- }
90617
- }
90618
- }
90619
- },
90620
- "responses": {
90497
+ "404": {
90498
+ "description": "Resource not found",
90499
+ "content": {
90500
+ "application/json": {
90501
+ "schema": {
90502
+ "title": "Basic Error",
90503
+ "description": "Basic Error",
90504
+ "type": "object",
90505
+ "properties": {
90506
+ "message": {
90507
+ "type": "string"
90508
+ },
90509
+ "documentation_url": {
90510
+ "type": "string"
90511
+ },
90512
+ "url": {
90513
+ "type": "string"
90514
+ },
90515
+ "status": {
90516
+ "type": "string"
90517
+ }
90518
+ }
90519
+ }
90520
+ }
90521
+ }
90522
+ }
90523
+ },
90524
+ "x-github": {
90525
+ "githubCloudOnly": false,
90526
+ "enabledForGitHubApps": true,
90527
+ "category": "teams",
90528
+ "subcategory": null
90529
+ },
90530
+ "x-octokit": {
90531
+ "diff": {
90532
+ "ghes-3.4": {
90533
+ "type": "changed"
90534
+ }
90535
+ }
90536
+ }
90537
+ },
90538
+ "patch": {
90539
+ "summary": "Update a team",
90540
+ "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}`.",
90541
+ "tags": [
90542
+ "teams"
90543
+ ],
90544
+ "operationId": "teams/update-in-org",
90545
+ "externalDocs": {
90546
+ "description": "API method documentation",
90547
+ "url": "https://docs.github.com/enterprise-server@3.3/rest/reference/teams#update-a-team"
90548
+ },
90549
+ "parameters": [
90550
+ {
90551
+ "name": "org",
90552
+ "description": "The organization name. The name is not case sensitive.",
90553
+ "in": "path",
90554
+ "required": true,
90555
+ "schema": {
90556
+ "type": "string"
90557
+ }
90558
+ },
90559
+ {
90560
+ "name": "team_slug",
90561
+ "description": "The slug of the team name.",
90562
+ "in": "path",
90563
+ "required": true,
90564
+ "schema": {
90565
+ "type": "string"
90566
+ }
90567
+ }
90568
+ ],
90569
+ "requestBody": {
90570
+ "required": false,
90571
+ "content": {
90572
+ "application/json": {
90573
+ "schema": {
90574
+ "type": "object",
90575
+ "properties": {
90576
+ "name": {
90577
+ "type": "string",
90578
+ "description": "The name of the team."
90579
+ },
90580
+ "description": {
90581
+ "type": "string",
90582
+ "description": "The description of the team."
90583
+ },
90584
+ "privacy": {
90585
+ "type": "string",
90586
+ "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.",
90587
+ "enum": [
90588
+ "secret",
90589
+ "closed"
90590
+ ]
90591
+ },
90592
+ "permission": {
90593
+ "type": "string",
90594
+ "description": "**Deprecated**. The permission that new repositories will be added to the team with when none is specified.",
90595
+ "enum": [
90596
+ "pull",
90597
+ "push",
90598
+ "admin"
90599
+ ],
90600
+ "default": "pull"
90601
+ },
90602
+ "parent_team_id": {
90603
+ "type": "integer",
90604
+ "description": "The ID of a team to set as the parent team.",
90605
+ "nullable": true
90606
+ }
90607
+ }
90608
+ },
90609
+ "examples": {
90610
+ "default": {
90611
+ "value": {
90612
+ "name": "new team name",
90613
+ "description": "new team description",
90614
+ "privacy": "closed"
90615
+ }
90616
+ }
90617
+ }
90618
+ }
90619
+ }
90620
+ },
90621
+ "responses": {
90622
+ "200": {
90623
+ "description": "Response when the updated information already exists",
90624
+ "content": {
90625
+ "application/json": {
90626
+ "schema": {
90627
+ "title": "Full Team",
90628
+ "description": "Groups of organization members that gives permissions on specified repositories.",
90629
+ "type": "object",
90630
+ "properties": {
90631
+ "id": {
90632
+ "description": "Unique identifier of the team",
90633
+ "example": 42,
90634
+ "type": "integer"
90635
+ },
90636
+ "node_id": {
90637
+ "type": "string",
90638
+ "example": "MDQ6VGVhbTE="
90639
+ },
90640
+ "url": {
90641
+ "description": "URL for the team",
90642
+ "example": "https://api.github.com/organizations/1/team/1",
90643
+ "type": "string",
90644
+ "format": "uri"
90645
+ },
90646
+ "html_url": {
90647
+ "type": "string",
90648
+ "format": "uri",
90649
+ "example": "https://github.com/orgs/rails/teams/core"
90650
+ },
90651
+ "name": {
90652
+ "description": "Name of the team",
90653
+ "example": "Developers",
90654
+ "type": "string"
90655
+ },
90656
+ "slug": {
90657
+ "type": "string",
90658
+ "example": "justice-league"
90659
+ },
90660
+ "description": {
90661
+ "type": "string",
90662
+ "example": "A great team.",
90663
+ "nullable": true
90664
+ },
90665
+ "privacy": {
90666
+ "description": "The level of privacy this team should have",
90667
+ "type": "string",
90668
+ "enum": [
90669
+ "closed",
90670
+ "secret"
90671
+ ],
90672
+ "example": "closed"
90673
+ },
90674
+ "permission": {
90675
+ "description": "Permission that the team will have for its repositories",
90676
+ "example": "push",
90677
+ "type": "string"
90678
+ },
90679
+ "members_url": {
90680
+ "type": "string",
90681
+ "example": "https://api.github.com/organizations/1/team/1/members{/member}"
90682
+ },
90683
+ "repositories_url": {
90684
+ "type": "string",
90685
+ "format": "uri",
90686
+ "example": "https://api.github.com/organizations/1/team/1/repos"
90687
+ },
90688
+ "parent": {
90689
+ "title": "Team Simple",
90690
+ "description": "Groups of organization members that gives permissions on specified repositories.",
90691
+ "type": "object",
90692
+ "properties": {
90693
+ "id": {
90694
+ "description": "Unique identifier of the team",
90695
+ "type": "integer",
90696
+ "example": 1
90697
+ },
90698
+ "node_id": {
90699
+ "type": "string",
90700
+ "example": "MDQ6VGVhbTE="
90701
+ },
90702
+ "url": {
90703
+ "description": "URL for the team",
90704
+ "type": "string",
90705
+ "format": "uri",
90706
+ "example": "https://api.github.com/organizations/1/team/1"
90707
+ },
90708
+ "members_url": {
90709
+ "type": "string",
90710
+ "example": "https://api.github.com/organizations/1/team/1/members{/member}"
90711
+ },
90712
+ "name": {
90713
+ "description": "Name of the team",
90714
+ "type": "string",
90715
+ "example": "Justice League"
90716
+ },
90717
+ "description": {
90718
+ "description": "Description of the team",
90719
+ "type": "string",
90720
+ "nullable": true,
90721
+ "example": "A great team."
90722
+ },
90723
+ "permission": {
90724
+ "description": "Permission that the team will have for its repositories",
90725
+ "type": "string",
90726
+ "example": "admin"
90727
+ },
90728
+ "privacy": {
90729
+ "description": "The level of privacy this team should have",
90730
+ "type": "string",
90731
+ "example": "closed"
90732
+ },
90733
+ "html_url": {
90734
+ "type": "string",
90735
+ "format": "uri",
90736
+ "example": "https://github.com/orgs/rails/teams/core"
90737
+ },
90738
+ "repositories_url": {
90739
+ "type": "string",
90740
+ "format": "uri",
90741
+ "example": "https://api.github.com/organizations/1/team/1/repos"
90742
+ },
90743
+ "slug": {
90744
+ "type": "string",
90745
+ "example": "justice-league"
90746
+ },
90747
+ "ldap_dn": {
90748
+ "description": "Distinguished Name (DN) that team maps to within LDAP environment",
90749
+ "example": "uid=example,ou=users,dc=github,dc=com",
90750
+ "type": "string"
90751
+ }
90752
+ },
90753
+ "required": [
90754
+ "id",
90755
+ "node_id",
90756
+ "url",
90757
+ "members_url",
90758
+ "name",
90759
+ "description",
90760
+ "permission",
90761
+ "html_url",
90762
+ "repositories_url",
90763
+ "slug"
90764
+ ],
90765
+ "nullable": true
90766
+ },
90767
+ "members_count": {
90768
+ "type": "integer",
90769
+ "example": 3
90770
+ },
90771
+ "repos_count": {
90772
+ "type": "integer",
90773
+ "example": 10
90774
+ },
90775
+ "created_at": {
90776
+ "type": "string",
90777
+ "format": "date-time",
90778
+ "example": "2017-07-14T16:53:42Z"
90779
+ },
90780
+ "updated_at": {
90781
+ "type": "string",
90782
+ "format": "date-time",
90783
+ "example": "2017-08-17T12:37:15Z"
90784
+ },
90785
+ "organization": {
90786
+ "title": "Team Organization",
90787
+ "description": "Team Organization",
90788
+ "type": "object",
90789
+ "properties": {
90790
+ "login": {
90791
+ "type": "string",
90792
+ "example": "github"
90793
+ },
90794
+ "id": {
90795
+ "type": "integer",
90796
+ "example": 1
90797
+ },
90798
+ "node_id": {
90799
+ "type": "string",
90800
+ "example": "MDEyOk9yZ2FuaXphdGlvbjE="
90801
+ },
90802
+ "url": {
90803
+ "type": "string",
90804
+ "format": "uri",
90805
+ "example": "https://api.github.com/orgs/github"
90806
+ },
90807
+ "repos_url": {
90808
+ "type": "string",
90809
+ "format": "uri",
90810
+ "example": "https://api.github.com/orgs/github/repos"
90811
+ },
90812
+ "events_url": {
90813
+ "type": "string",
90814
+ "format": "uri",
90815
+ "example": "https://api.github.com/orgs/github/events"
90816
+ },
90817
+ "hooks_url": {
90818
+ "type": "string",
90819
+ "example": "https://api.github.com/orgs/github/hooks"
90820
+ },
90821
+ "issues_url": {
90822
+ "type": "string",
90823
+ "example": "https://api.github.com/orgs/github/issues"
90824
+ },
90825
+ "members_url": {
90826
+ "type": "string",
90827
+ "example": "https://api.github.com/orgs/github/members{/member}"
90828
+ },
90829
+ "public_members_url": {
90830
+ "type": "string",
90831
+ "example": "https://api.github.com/orgs/github/public_members{/member}"
90832
+ },
90833
+ "avatar_url": {
90834
+ "type": "string",
90835
+ "example": "https://github.com/images/error/octocat_happy.gif"
90836
+ },
90837
+ "description": {
90838
+ "type": "string",
90839
+ "example": "A great organization",
90840
+ "nullable": true
90841
+ },
90842
+ "name": {
90843
+ "type": "string",
90844
+ "example": "github"
90845
+ },
90846
+ "company": {
90847
+ "type": "string",
90848
+ "example": "GitHub"
90849
+ },
90850
+ "blog": {
90851
+ "type": "string",
90852
+ "format": "uri",
90853
+ "example": "https://github.com/blog"
90854
+ },
90855
+ "location": {
90856
+ "type": "string",
90857
+ "example": "San Francisco"
90858
+ },
90859
+ "email": {
90860
+ "type": "string",
90861
+ "format": "email",
90862
+ "example": "octocat@github.com"
90863
+ },
90864
+ "twitter_username": {
90865
+ "type": "string",
90866
+ "example": "github",
90867
+ "nullable": true
90868
+ },
90869
+ "is_verified": {
90870
+ "type": "boolean",
90871
+ "example": true
90872
+ },
90873
+ "has_organization_projects": {
90874
+ "type": "boolean",
90875
+ "example": true
90876
+ },
90877
+ "has_repository_projects": {
90878
+ "type": "boolean",
90879
+ "example": true
90880
+ },
90881
+ "public_repos": {
90882
+ "type": "integer",
90883
+ "example": 2
90884
+ },
90885
+ "public_gists": {
90886
+ "type": "integer",
90887
+ "example": 1
90888
+ },
90889
+ "followers": {
90890
+ "type": "integer",
90891
+ "example": 20
90892
+ },
90893
+ "following": {
90894
+ "type": "integer",
90895
+ "example": 0
90896
+ },
90897
+ "html_url": {
90898
+ "type": "string",
90899
+ "format": "uri",
90900
+ "example": "https://github.com/octocat"
90901
+ },
90902
+ "created_at": {
90903
+ "type": "string",
90904
+ "format": "date-time",
90905
+ "example": "2008-01-14T04:33:35Z"
90906
+ },
90907
+ "type": {
90908
+ "type": "string",
90909
+ "example": "Organization"
90910
+ },
90911
+ "total_private_repos": {
90912
+ "type": "integer",
90913
+ "example": 100
90914
+ },
90915
+ "owned_private_repos": {
90916
+ "type": "integer",
90917
+ "example": 100
90918
+ },
90919
+ "private_gists": {
90920
+ "type": "integer",
90921
+ "example": 81,
90922
+ "nullable": true
90923
+ },
90924
+ "disk_usage": {
90925
+ "type": "integer",
90926
+ "example": 10000,
90927
+ "nullable": true
90928
+ },
90929
+ "collaborators": {
90930
+ "type": "integer",
90931
+ "example": 8,
90932
+ "nullable": true
90933
+ },
90934
+ "billing_email": {
90935
+ "type": "string",
90936
+ "format": "email",
90937
+ "example": "org@example.com",
90938
+ "nullable": true
90939
+ },
90940
+ "plan": {
90941
+ "type": "object",
90942
+ "properties": {
90943
+ "name": {
90944
+ "type": "string"
90945
+ },
90946
+ "space": {
90947
+ "type": "integer"
90948
+ },
90949
+ "private_repos": {
90950
+ "type": "integer"
90951
+ },
90952
+ "filled_seats": {
90953
+ "type": "integer"
90954
+ },
90955
+ "seats": {
90956
+ "type": "integer"
90957
+ }
90958
+ },
90959
+ "required": [
90960
+ "name",
90961
+ "space",
90962
+ "private_repos"
90963
+ ]
90964
+ },
90965
+ "default_repository_permission": {
90966
+ "type": "string",
90967
+ "nullable": true
90968
+ },
90969
+ "members_can_create_repositories": {
90970
+ "type": "boolean",
90971
+ "example": true,
90972
+ "nullable": true
90973
+ },
90974
+ "two_factor_requirement_enabled": {
90975
+ "type": "boolean",
90976
+ "example": true,
90977
+ "nullable": true
90978
+ },
90979
+ "members_allowed_repository_creation_type": {
90980
+ "type": "string",
90981
+ "example": "all"
90982
+ },
90983
+ "members_can_create_public_repositories": {
90984
+ "type": "boolean",
90985
+ "example": true
90986
+ },
90987
+ "members_can_create_private_repositories": {
90988
+ "type": "boolean",
90989
+ "example": true
90990
+ },
90991
+ "members_can_create_internal_repositories": {
90992
+ "type": "boolean",
90993
+ "example": true
90994
+ },
90995
+ "members_can_create_pages": {
90996
+ "type": "boolean",
90997
+ "example": true
90998
+ },
90999
+ "members_can_create_public_pages": {
91000
+ "type": "boolean",
91001
+ "example": true
91002
+ },
91003
+ "members_can_create_private_pages": {
91004
+ "type": "boolean",
91005
+ "example": true
91006
+ },
91007
+ "updated_at": {
91008
+ "type": "string",
91009
+ "format": "date-time"
91010
+ }
91011
+ },
91012
+ "required": [
91013
+ "login",
91014
+ "url",
91015
+ "id",
91016
+ "node_id",
91017
+ "repos_url",
91018
+ "events_url",
91019
+ "hooks_url",
91020
+ "issues_url",
91021
+ "members_url",
91022
+ "public_members_url",
91023
+ "avatar_url",
91024
+ "description",
91025
+ "html_url",
91026
+ "has_organization_projects",
91027
+ "has_repository_projects",
91028
+ "public_repos",
91029
+ "public_gists",
91030
+ "followers",
91031
+ "following",
91032
+ "type",
91033
+ "created_at",
91034
+ "updated_at"
91035
+ ]
91036
+ },
91037
+ "ldap_dn": {
91038
+ "description": "Distinguished Name (DN) that team maps to within LDAP environment",
91039
+ "example": "uid=example,ou=users,dc=github,dc=com",
91040
+ "type": "string"
91041
+ }
91042
+ },
91043
+ "required": [
91044
+ "id",
91045
+ "node_id",
91046
+ "url",
91047
+ "members_url",
91048
+ "name",
91049
+ "description",
91050
+ "permission",
91051
+ "html_url",
91052
+ "repositories_url",
91053
+ "slug",
91054
+ "created_at",
91055
+ "updated_at",
91056
+ "members_count",
91057
+ "repos_count",
91058
+ "organization"
91059
+ ]
91060
+ },
91061
+ "examples": {
91062
+ "default": {
91063
+ "value": {
91064
+ "id": 1,
91065
+ "node_id": "MDQ6VGVhbTE=",
91066
+ "url": "https://api.github.com/teams/1",
91067
+ "html_url": "https://github.com/orgs/github/teams/justice-league",
91068
+ "name": "Justice League",
91069
+ "slug": "justice-league",
91070
+ "description": "A great team.",
91071
+ "privacy": "closed",
91072
+ "permission": "admin",
91073
+ "members_url": "https://api.github.com/teams/1/members{/member}",
91074
+ "repositories_url": "https://api.github.com/teams/1/repos",
91075
+ "members_count": 3,
91076
+ "repos_count": 10,
91077
+ "created_at": "2017-07-14T16:53:42Z",
91078
+ "updated_at": "2017-08-17T12:37:15Z",
91079
+ "organization": {
91080
+ "login": "github",
91081
+ "id": 1,
91082
+ "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
91083
+ "url": "https://api.github.com/orgs/github",
91084
+ "repos_url": "https://api.github.com/orgs/github/repos",
91085
+ "events_url": "https://api.github.com/orgs/github/events",
91086
+ "hooks_url": "https://api.github.com/orgs/github/hooks",
91087
+ "issues_url": "https://api.github.com/orgs/github/issues",
91088
+ "members_url": "https://api.github.com/orgs/github/members{/member}",
91089
+ "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
91090
+ "avatar_url": "https://github.com/images/error/octocat_happy.gif",
91091
+ "description": "A great organization",
91092
+ "name": "github",
91093
+ "company": "GitHub",
91094
+ "blog": "https://github.com/blog",
91095
+ "location": "San Francisco",
91096
+ "email": "octocat@github.com",
91097
+ "has_organization_projects": true,
91098
+ "has_repository_projects": true,
91099
+ "public_repos": 2,
91100
+ "public_gists": 1,
91101
+ "followers": 20,
91102
+ "following": 0,
91103
+ "html_url": "https://github.com/octocat",
91104
+ "created_at": "2008-01-14T04:33:35Z",
91105
+ "updated_at": "2017-08-17T12:37:15Z",
91106
+ "type": "Organization"
91107
+ },
91108
+ "ldap_dn": "uid=asdf,ou=users,dc=github,dc=com"
91109
+ }
91110
+ }
91111
+ }
91112
+ }
91113
+ }
91114
+ },
90621
91115
  "201": {
90622
91116
  "description": "Response",
90623
91117
  "content": {
@@ -91110,6 +91604,127 @@
91110
91604
  }
91111
91605
  }
91112
91606
  }
91607
+ },
91608
+ "403": {
91609
+ "description": "Forbidden",
91610
+ "content": {
91611
+ "application/json": {
91612
+ "schema": {
91613
+ "title": "Basic Error",
91614
+ "description": "Basic Error",
91615
+ "type": "object",
91616
+ "properties": {
91617
+ "message": {
91618
+ "type": "string"
91619
+ },
91620
+ "documentation_url": {
91621
+ "type": "string"
91622
+ },
91623
+ "url": {
91624
+ "type": "string"
91625
+ },
91626
+ "status": {
91627
+ "type": "string"
91628
+ }
91629
+ }
91630
+ }
91631
+ }
91632
+ }
91633
+ },
91634
+ "404": {
91635
+ "description": "Resource not found",
91636
+ "content": {
91637
+ "application/json": {
91638
+ "schema": {
91639
+ "title": "Basic Error",
91640
+ "description": "Basic Error",
91641
+ "type": "object",
91642
+ "properties": {
91643
+ "message": {
91644
+ "type": "string"
91645
+ },
91646
+ "documentation_url": {
91647
+ "type": "string"
91648
+ },
91649
+ "url": {
91650
+ "type": "string"
91651
+ },
91652
+ "status": {
91653
+ "type": "string"
91654
+ }
91655
+ }
91656
+ }
91657
+ }
91658
+ }
91659
+ },
91660
+ "422": {
91661
+ "description": "Validation failed",
91662
+ "content": {
91663
+ "application/json": {
91664
+ "schema": {
91665
+ "title": "Validation Error",
91666
+ "description": "Validation Error",
91667
+ "type": "object",
91668
+ "required": [
91669
+ "message",
91670
+ "documentation_url"
91671
+ ],
91672
+ "properties": {
91673
+ "message": {
91674
+ "type": "string"
91675
+ },
91676
+ "documentation_url": {
91677
+ "type": "string"
91678
+ },
91679
+ "errors": {
91680
+ "type": "array",
91681
+ "items": {
91682
+ "type": "object",
91683
+ "required": [
91684
+ "code"
91685
+ ],
91686
+ "properties": {
91687
+ "resource": {
91688
+ "type": "string"
91689
+ },
91690
+ "field": {
91691
+ "type": "string"
91692
+ },
91693
+ "message": {
91694
+ "type": "string"
91695
+ },
91696
+ "code": {
91697
+ "type": "string"
91698
+ },
91699
+ "index": {
91700
+ "type": "integer"
91701
+ },
91702
+ "value": {
91703
+ "oneOf": [
91704
+ {
91705
+ "type": "string",
91706
+ "nullable": true
91707
+ },
91708
+ {
91709
+ "type": "integer",
91710
+ "nullable": true
91711
+ },
91712
+ {
91713
+ "type": "array",
91714
+ "nullable": true,
91715
+ "items": {
91716
+ "type": "string"
91717
+ }
91718
+ }
91719
+ ]
91720
+ }
91721
+ }
91722
+ }
91723
+ }
91724
+ }
91725
+ }
91726
+ }
91727
+ }
91113
91728
  }
91114
91729
  },
91115
91730
  "x-github": {
@@ -112510,8 +113125,9 @@
112510
113125
  },
112511
113126
  "use_squash_pr_title_as_default": {
112512
113127
  "type": "boolean",
112513
- "description": "Either `true` to allow squash-merge commits to use pull request title, or `false` to use commit message.",
112514
- "default": false
113128
+ "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.",
113129
+ "default": false,
113130
+ "deprecated": true
112515
113131
  },
112516
113132
  "squash_merge_commit_title": {
112517
113133
  "type": "string",
@@ -133259,7 +133875,7 @@
133259
133875
  },
133260
133876
  "/repos/{owner}/{repo}/actions/workflows/{workflow_id}/runs": {
133261
133877
  "get": {
133262
- "summary": "List workflow runs",
133878
+ "summary": "List workflow runs for a workflow",
133263
133879
  "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/enterprise-server@3.3/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.",
133264
133880
  "tags": [
133265
133881
  "actions"
@@ -172014,6 +172630,22 @@
172014
172630
  "default": "all"
172015
172631
  }
172016
172632
  },
172633
+ {
172634
+ "name": "permission",
172635
+ "description": "Filter collaborators by the permissions they have on the repository. If not specified, all collaborators will be returned.",
172636
+ "in": "query",
172637
+ "required": false,
172638
+ "schema": {
172639
+ "type": "string",
172640
+ "enum": [
172641
+ "pull",
172642
+ "triage",
172643
+ "push",
172644
+ "maintain",
172645
+ "admin"
172646
+ ]
172647
+ }
172648
+ },
172017
172649
  {
172018
172650
  "name": "per_page",
172019
172651
  "description": "The number of results per page (max 100).",
@@ -190168,6 +190800,7 @@
190168
190800
  "description": "The base branch and head branch to compare. This parameter expects the format `{base}...{head}`.",
190169
190801
  "in": "path",
190170
190802
  "required": true,
190803
+ "x-multi-segment": true,
190171
190804
  "schema": {
190172
190805
  "type": "string"
190173
190806
  }
@@ -193259,7 +193892,7 @@
193259
193892
  },
193260
193893
  "put": {
193261
193894
  "summary": "Create or update file contents",
193262
- "description": "Creates a new file or replaces an existing file in a repository.",
193895
+ "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.",
193263
193896
  "tags": [
193264
193897
  "repos"
193265
193898
  ],
@@ -194016,7 +194649,7 @@
194016
194649
  },
194017
194650
  "sha": {
194018
194651
  "type": "string",
194019
- "description": "The blob SHA of the file being replaced."
194652
+ "description": "The blob SHA of the file being deleted."
194020
194653
  },
194021
194654
  "branch": {
194022
194655
  "type": "string",
@@ -214377,7 +215010,7 @@
214377
215010
  "/repos/{owner}/{repo}/git/trees/{tree_sha}": {
214378
215011
  "get": {
214379
215012
  "summary": "Get a tree",
214380
- "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.",
215013
+ "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.",
214381
215014
  "tags": [
214382
215015
  "git"
214383
215016
  ],
@@ -214687,7 +215320,7 @@
214687
215320
  "/repos/{owner}/{repo}/hooks": {
214688
215321
  "get": {
214689
215322
  "summary": "List repository webhooks",
214690
- "description": "",
215323
+ "description": "Lists webhooks for a repository. `last response` may return null if there have not been any deliveries within 30 days.",
214691
215324
  "tags": [
214692
215325
  "repos"
214693
215326
  ],