github-ops

GitHub REST API integration for managing repositories, issues, pull requests, and Actions workflows.

Setup

1. Create a Personal Access Token at https://github.com/settings/tokens
2. Required scopes: repo, workflow, read:user (minimum)
3. Store in environment: GH_TOKEN=ghp_xxx

API Basics

All requests need:

curl -H "Authorization: Bearer $GH_TOKEN" \
     -H "Accept: application/vnd.github+json" \
     -H "X-GitHub-Api-Version: 2022-11-28" \
     https://api.github.com/...

Common Operations

Get authenticated user

curl -H "Authorization: Bearer $GH_TOKEN" https://api.github.com/user

List user repos

curl -H "Authorization: Bearer $GH_TOKEN" https://api.github.com/user/repos

Get repo

curl -H "Authorization: Bearer $GH_TOKEN" https://api.github.com/repos/{owner}/{repo}

Create issue

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/issues \
  -d '{"title":"Bug report","body":"Description"}'

List issues

curl -H "Authorization: Bearer $GH_TOKEN" \
  https://api.github.com/repos/{owner}/{repo}/issues?state=open

Get issue

curl -H "Authorization: Bearer $GH_TOKEN" \
  https://api.github.com/repos/{owner}/{repo}/issues/{number}

Update issue

curl -X PATCH \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/issues/{number} \
  -d '{"state":"closed"}'

Add comment to issue

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/issues/{number}/comments \
  -d '{"body":"My comment"}'

Create PR

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/pulls \
  -d '{"title":"New feature","head":"feature-branch","base":"main"}'

List PRs

curl -H "Authorization: Bearer $GH_TOKEN" \
  https://api.github.com/repos/{owner}/{repo}/pulls?state=open

Get workflow runs

curl -H "Authorization: Bearer $GH_TOKEN" \
  https://api.github.com/repos/{owner}/{repo}/actions/runs?status=in_progress

Trigger workflow

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches \
  -d '{"ref":"main"}'

Add labels to issue

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/issues/{number}/labels \
  -d '{"labels":["bug","critical"]}'

Remove label from issue

curl -X DELETE \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/issues/{number}/labels/{label_name}

Get PR reviews

curl -H "Authorization: Bearer $GH_TOKEN" \
  https://api.github.com/repos/{owner}/{repo}/pulls/{number}/reviews

Create PR review

curl -X POST \
  -H "Authorization: Bearer $GH_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  https://api.github.com/repos/{owner}/{repo}/pulls/{number}/reviews \
  -d '{"body":"LGTM","event":"APPROVE"}'

Notes

• Repository owner/repo format: owner/repo (e.g., octocat/Hello-World)
• Rate limits: 5000 requests/hour for authenticated users
• All timestamps are ISO 8601 format