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

[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
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
[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
[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
[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
[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
[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] 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] 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] 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 and schema mismatch for `#/paths/~1enterprises~1{enterprise}~1settings~1billing~1budgets~1{budget_id}/patch` Open

feature

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

github/rest-api-description#5588 · Opened Nov 8, 2025
[Schema Inaccuracy] head.label and head.user can be null in pull-request schema Open

feature

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

github/rest-api-description#5562 · 2 comments · Opened Nov 4, 2025
[Schema Inaccuracy] repository variables permission missing from app-permissions Open

feature

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

github/rest-api-description#5437 · 2 comments · Opened Oct 8, 2025
[Schema Inaccuracy] Create and update org repository missing `has_discussions` parameters Open

feature fundamentals-and-support

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

github/rest-api-description#4842 · Opened May 15, 2025
[Schema Inaccuracy] Example and schema mismatch at patch-schema Open

documentation

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

github/rest-api-description#4470 · 2 comments · Opened Jan 26, 2025
[Schema Inaccuracy] webhook-workflow-run-* components define pull request numbers and ids as 'number' instead of 'integer' Open

feature

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

github/rest-api-description#4408 · Opened Jan 6, 2025
[Schema Inaccuracy] /orgs/{org}/dependabot/alerts schema is missing 'page' Open

documentation

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

github/rest-api-description#4350 · 2 comments · Opened Dec 2, 2024
[Schema Inaccuracy] Pull Request Files Changed `blob_url`, `raw_url`, and `sha` should be nullable Open

feature inaccuracy P3

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

github/rest-api-description#1945 · 5 comments · Opened Dec 5, 2022

A short digest of beginner-friendly GitHub issues.