github/rest-api-description

An OpenAPI description for GitHub's REST API

Stars: 1.6k
Forks: 342
Open beginner issues: 31
Indexed issues: 173
Avg merge: 3h 33m
Merged PRs (30d): 51

Dominant language: No language data
License: MIT
Last GitHub push: Sep 18, 2026
Latest indexed: Sep 16, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: No beginner labels indexed

Beginner friendly Everything

Open All

173 issues indexed so far

[Schema Inaccuracy] `X-GitHub-Hook-Installation-Target-Type` and `X-GitHub-Hook-Installation-Target-Id` are insufficiently documented (and incorrect) Open

feature

Difficulty 3/5 1-2 days Newbie friendliness 68/100

github/rest-api-description#7210 · 1 reaction · Opened Sep 16, 2026
[Schema Inaccuracy] Missing Link header from org/security-advisories response description Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

github/rest-api-description#7201 · Opened Sep 15, 2026
[Schema Inaccuracy] community-profile files.issue_template is null for a .github/ISSUE_TEMPLATE/ directory the community page counts Open

feature

Difficulty 3/5 1-2 days Newbie friendliness 58/100

github/rest-api-description#7187 · 1 comment · Opened Sep 12, 2026
Runner deprecations: enterprise scope is in the changelog and the 404 handler but not in the description Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

github/rest-api-description#7163 · Opened Sep 9, 2026
Runner deprecations: registration_deprecates_at is declared on the response but never returned Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#7162 · Opened Sep 9, 2026
configure-pages API endpoint yields anchor that doesn't exist in docs Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#7135 · Opened Sep 4, 2026
Document RepositoryRole actor_id values for ruleset bypass_actors — critical security feature, currently undocumented Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

github/rest-api-description#7111 · 1 comment · Opened Sep 1, 2026
branches: GET /repos/{owner}/{repo}/branches/master 301-redirects to the current default branch; response semantics undocumented Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#7096 · Opened Aug 28, 2026
`HTTP 410` version promise is untestable Open

feature

Difficulty 5/5 Over a week Newbie friendliness 25/100

github/rest-api-description#7054 · Opened Aug 21, 2026
`/authorizations_url` is still a thing in the `/` endpoint under `2026-03-10` contrary to the documentation Open

documentation

Difficulty 3/5 1-2 days Newbie friendliness 63/100

github/rest-api-description#7053 · 2 comments · Opened Aug 21, 2026
[Schema Inaccuracy] `permission` on Add a repository collaborator is valid on personal-account repositories Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 85/100

github/rest-api-description#7010 · 1 comment · Opened Aug 18, 2026
Create issue comment requires both Issues and Pull requests write for GitHub App installation tokens Open

documentation

Difficulty 4/5 3-5 days Newbie friendliness 35/100

github/rest-api-description#6994 · 1 comment · Opened Aug 15, 2026
[Schema Inaccuracy] Checks and Actions request IDs are missing int64 formats Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

github/rest-api-description#6930 · Opened Aug 5, 2026
[Schema Inaccuracy] Missing allow_auto_merge in repos/update request body on GHES Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 84/100

github/rest-api-description#6902 · Opened Jul 31, 2026
docs inconsistency for environment creation and unreasonable permissions required Open

feature

Difficulty 3/5 1-2 days Newbie friendliness 58/100

github/rest-api-description#6745 · Opened Jul 11, 2026
[Schema Inaccuracy] scim-enterprise-user examples use "User" (capital U) but user-role schema enum only defines "user" (lowercase) Open

documentation

github/rest-api-description#6644 · 1 comment · 1 assignee · Opened Jun 27, 2026
[Schema Inaccuracy] *-roles list endpoints missing per_page/page params despite live API paginating Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 74/100

github/rest-api-description#6474 · Opened May 21, 2026
[Schema Inaccuracy] `agent_assignment` is missing from the `issues ` schema. Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

github/rest-api-description#6466 · 1 reaction · Opened May 20, 2026
Muitilile error during generation openapi client from swagger Open

feature

Difficulty 4/5 3-5 days Newbie friendliness 42/100

github/rest-api-description#6455 · Opened May 16, 2026
[Schema Inaccuracy] inconsistent issue schemas in webhooks Open

feature

Difficulty 4/5 3-5 days Newbie friendliness 48/100

github/rest-api-description#6448 · Opened May 14, 2026
[Schema Inaccuracy] `/versions` wrong order Open

effort-small fundamentals-and-support

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

github/rest-api-description#6376 · 2 reactions · Opened May 4, 2026
GET /repos/{owner}/{repo}/actions/runs: bot committer emails fail `format: "email"` validation Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#6355 · 2 comments · Opened Apr 30, 2026
GET /user/repos: `homepage` field declared as format "uri" but API returns empty string "" Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 62/100

github/rest-api-description#6354 · 2 comments · Opened Apr 30, 2026
[Schema Inaccuracy] pull-request-review.state and two siblings should be enum, not string Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

github/rest-api-description#6345 · 1 comment · Opened Apr 27, 2026
[Schema Inaccuracy] 2026-03-10 pull_request webhook payloads are missing merge_commit_sha Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#6344 · 1 comment · Opened Apr 27, 2026
[Schema Inaccuracy] (GHES 3.18) organization_copilot_seat_management property on the app-permissions schema is missing read Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

github/rest-api-description#6272 · 1 comment · Opened Apr 10, 2026
[Missing API] Add dependabot_malware_alerts to security_and_analysis on PATCH /repos/{owner}/{repo} Open

documentation

Difficulty 5/5 Over a week Newbie friendliness 45/100

github/rest-api-description#6251 · 2 reactions · Opened Apr 7, 2026
[Schema Inaccuracy] Wordy Plan availability prefix in branch protection endpoint descriptions Open

feature

Difficulty 3/5 1-2 days Newbie friendliness 48/100

github/rest-api-description#6235 · Opened Apr 4, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1search~1issues/get` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#6233 · Opened Apr 4, 2026
[API Docs inaccuracy] <Get a Commit Comment> Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#6147 · 1 comment · Opened Mar 25, 2026
[Schema Inaccuracy] code_scanning_alert reopened webhook: dismissed_by typed as empty object {} instead of simple-user Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#6107 · 2 comments · Opened Mar 19, 2026
[Schema Inaccuracy] `GET /repos/{owner}/{repo}/contents/{path}` spec is missing raw+json / html+json response media types Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 45/100

github/rest-api-description#6089 · Opened Mar 7, 2026
[Schema Inaccuracy] code_scanning_alert closed_by_user webhook: fixed_at typed as null instead of date-time string Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 52/100

github/rest-api-description#6081 · Opened Mar 4, 2026
[Schema Inaccuracy] code_scanning_alert fixed webhook: alert.state typed as null | "fixed" but GitHub sends "dismissed" Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 64/100

github/rest-api-description#6059 · 2 comments · Opened Feb 28, 2026
[Schema Inaccuracy] code_scanning_alert fixed webhook: fixed_at typed as null instead of date-time string Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

github/rest-api-description#6058 · Opened Feb 28, 2026
[Schema Inaccuracy] GET method for issues has requestBody Open

documentation

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

github/rest-api-description#5995 · 1 comment · Opened Feb 19, 2026
pull-request.base.sha undocumented, possibly useless? Open

documentation

Difficulty 3/5 1-2 days Newbie friendliness 35/100

github/rest-api-description#5978 · 1 comment · Opened Feb 16, 2026
[Schema Inaccuracy] installation-token.expires_at is string. Should be date-time Open

feature

Difficulty 2/5 Under an hour Newbie friendliness 50/100

github/rest-api-description#5943 · Opened Feb 5, 2026
[Schema Inaccuracy] repository_vulnerability_alert webhook action create missing state auto_dismissed Open

documentation

Difficulty 1/5 Under an hour Newbie friendliness 48/100

github/rest-api-description#5913 · 1 comment · Opened Jan 30, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1scim~1v2~1organizations~1{org}~1Users~1{scim_user_id}/patch` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

github/rest-api-description#5874 · Opened Jan 22, 2026
[Schema Inaccuracy] Wrong media types in rest/gists/comments.md Open

feature

Difficulty 1/5 Under an hour Newbie friendliness 68/100

github/rest-api-description#5869 · Opened Jan 19, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1classrooms~1{classroom_id}~1assignments/get` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

github/rest-api-description#5865 · Opened Jan 18, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1classrooms~1{classroom_id}/get` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 50/100

github/rest-api-description#5864 · Opened Jan 18, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1classrooms/get` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

github/rest-api-description#5863 · Opened Jan 18, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1assignments~1{assignment_id}~1accepted_assignments/get` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

github/rest-api-description#5862 · Opened Jan 18, 2026
[Schema Inaccuracy] Example and schema mismatch for `#/paths/~1users~1{username}~1attestations~1bulk-list/post` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 48/100

github/rest-api-description#5861 · Opened Jan 17, 2026
[Schema Inaccuracy] Boolean default value for string-type `make_latest` parameter in `repos/update-release` Open

feature

Difficulty 1/5 Under an hour Newbie friendliness 50/100

github/rest-api-description#5858 · Opened Jan 17, 2026
[Schema Inaccuracy] Missing `allow_update_branch` property on `POST /user/repos` Open

feature

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

github/rest-api-description#5857 · Opened Jan 17, 2026
[Schema Inaccuracy] Example response for "List a connection between an external group and a team" is invalid Open

documentation

Difficulty 1/5 Under an hour Newbie friendliness 45/100

github/rest-api-description#5852 · 1 comment · Opened Jan 16, 2026
[Schema Inaccuracy] Repository Vulnerability Alert's webhook create action missing lots of fields for Organization, Repository, and Sender Open

feature

Difficulty 3/5 1-2 days Newbie friendliness 48/100

github/rest-api-description#5838 · 1 comment · Opened Jan 14, 2026

A short digest of beginner-friendly GitHub issues.