GitHub CLI

API Commands

Access the GitHub API directly from the command line. Learn to make REST and GraphQL requests for automation and custom integrations.

5 commands

Pro Tips

Use 'gh api graphql' for complex queries that would require multiple REST calls.

Paginate through results with '--paginate' flag: 'gh api repos/org/repo/issues --paginate'

Use jq for processing: 'gh api user/repos --jq ".[].name"' to extract specific fields.

API rate limits apply. Authenticated requests get 5000/hour, use conditionals to avoid waste.

$ gh api <endpoint>

Make GET request to GitHub API

$ gh api graphql -f query='<query>'

Execute GraphQL query against GitHub API

$ gh api <endpoint> --paginate

Automatically paginate through all results

$ gh api <endpoint> --method POST -f key=value

Make POST request to GitHub API

$ gh api repos/<owner>/<repo>

Get repository information via API