github-api

# GitHub Access the GitHub REST API with managed OAuth authentication. Manage repositories, issues, pull requests, commits, branches, users, and more. ## Quick Start ```bash # Get authenticated user python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/github/user') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ## Base URL ``` https://gateway.maton.ai/github/{native-api-path} ``` Replace `{native-api-path}` with the actual GitHub API endpoint path. The gateway proxies requests to `api.github.com` and automatically injects your OAuth token. ## Authentication All requests require the Maton API key in the Authorization header: ``` Authorization: Bearer $MATON_API_KEY ``` **Environment Variable:** Set your API key as `MATON_API_KEY`: ```bash export MATON_API_KEY="YOUR_API_KEY" ``` ### Getting Your API Key 1. Sign in or create an account at [maton.ai](https://maton.ai) 2. Go to [maton.ai/settings](https://maton.ai/settings) 3. Copy your API key ## Connection Management Manage your GitHub OAuth connections at `https://ctrl.maton.ai`. ### List Connections ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=github&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Create Connection ```bash python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'github'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Get Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` **Response:** ```json { "connection": { "connection_id": "83e7c665-60f6-4a64-816c-5e287ea8982f", "status": "ACTIVE", "creation_time": "2026-02-06T03:00:43.860014Z", "last_updated_time": "2026-02-06T03:01:06.027323Z", "url": "https://connect.maton.ai/?session_token=...", "app": "github", "metadata": {} } } ``` Open the returned `url` in a browser to complete OAuth authorization. ### Delete Connection ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` ### Specifying Connection If you have multiple GitHub connections, specify which one to use with the `Maton-Connection` header: ```bash python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/github/user') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '83e7c665-60f6-4a64-816c-5e287ea8982f') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ``` If omitted, the gateway uses the default (oldest) active connection. ## API Reference ### Users #### Get Authenticated User ```bash GET /github/user ``` #### Get User by Username ```bash GET /github/users/{username} ``` #### List Users ```bash GET /github/users?since={user_id}&per_page=30 ``` ### Repositories #### List User Repositories ```bash GET /github/user/repos?per_page=30&sort=updated ``` Query parameters: `type` (all, owner, public, private, member), `sort` (created, updated, pushed, full_name), `direction` (asc, desc), `per_page`, `page` #### List Organization Repositories ```bash GET /github/orgs/{org}/repos?per_page=30 ``` #### Get Repository ```bash GET /github/repos/{owner}/{repo} ``` #### Create Repository (User) ```bash POST /github/user/repos Content-Type: application/json { "name": "my-new-repo", "description": "A new repository", "private": true, "auto_init": true } ``` #### Create Repository (Organization) ```bash POST /github/orgs/{org}/repos Content-Type: application/json { "name": "my-new-repo", "description": "A new repository", "private": true } ``` #### Update Repository ```bash PATCH /github/repos/{owner}/{repo} Content-Type: application/json { "description": "Updated description", "has_issues": true, "has_wiki": false } ``` #### Delete Repository ```bash DELETE /github/repos/{owner}/{repo} ``` ### Repository Contents #### List Contents ```bash GET /github/repos/{owner}/{repo}/contents/{path} ``` #### Get File Contents ```bash GET /github/repos/{owner}/{repo}/contents/{path}?ref={branch} ``` #### Create or Update File ```bash PUT /github/repos/{owner}/{repo}/contents/{path} Content-Type: application/json { "message": "Create new file", "content": "SGVsbG8gV29ybGQh", "branch": "main" } ``` Note: `content` must be Base64 encoded. #### Delete File ```bash DELETE /github/repos/{owner}/{repo}/contents/{path} Content-Type: application/json { "message": "Delete file", "sha": "{file_sha}", "branch": "main" } ``` ### Branches #### List Branches ```bash GET /github/repos/{owner}/{repo}/branches?per_page=30 ``` #### Get Branch ```bash GET /github/repos/{owner}/{repo}/branches/{branch} ``` #### Rename Branch ```bash POST /github/repos/{owner}/{repo}/branches/{branch}/rename Content-Type: application/json { "new_name": "new-branch-name" } ``` #### Merge Branches ```bash POST /github/repos/{owner}/{repo}/merges Content-Type: application/json { "base": "main", "head": "feature-branch", "commit_message": "Merge feature branch" } ``` ### Commits #### List Commits ```bash GET /github/repos/{owner}/{repo}/commits?per_page=30 ``` Query parameters: `sha` (branch name or commit SHA), `path` (file path), `author`, `committer`, `since`, `until`, `per_page`, `page` #### Get Commit ```bash GET /github/repos/{owner}/{repo}/commits/{ref} ``` #### Compare Two Commits ```bash GET /github/repos/{owner}/{repo}/compare/{base}...{head} ``` ### Issues #### List Repository Issues ```bash GET /github/repos/{owner}/{repo}/issues?state=open&per_page=30 ``` Query parameters: `state` (open, closed, all), `labels`, `assignee`, `creator`, `mentioned`, `sort`, `direction`, `since`, `per_page`, `page` #### Get Issue ```bash GET /github/repos/{owner}/{repo}/issues/{issue_number} ``` #### Create Issue ```bash POST /github/repos/{owner}/{repo}/issues Content-Type: application/json { "title": "Found a bug", "body": "Bug description here", "labels": ["bug"], "assignees": ["username"] } ``` #### Update Issue ```bash PATCH /github/repos/{owner}/{repo}/issues/{issue_number} Content-Type: application/json { "state": "closed", "state_reason": "completed" } ``` #### Lock Issue ```bash PUT /github/repos/{owner}/{repo}/issues/{issue_number}/lock Content-Type: application/json { "lock_reason": "resolved" } ``` #### Unlock Issue ```bash DELETE /github/repos/{owner}/{repo}/issues/{issue_number}/lock ``` ### Issue Comments #### List Issue Comments ```bash GET /github/repos/{owner}/{repo}/issues/{issue_number}/comments?per_page=30 ``` #### Create Issue Comment ```bash POST /github/repos/{owner}/{repo}/issues/{issue_number}/comments Content-Type: application/json { "body": "This is a comment" } ``` #### Update Issue Comment