🔌 API Reference

RESTful API for programmatic access to OpenCodeHub.

🔐 Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer YOUR_API_TOKEN

Create tokens in Settings → Developer → API Tokens.

📁 Repositories

GET /api/repos List repositories
GET /api/repos/:owner/:repo Get repository
POST /api/repos Create repository
DELETE /api/repos/:owner/:repo Delete repository

Example

curl -H "Authorization: Bearer TOKEN" \
  https://git.example.com/api/repos/user/project

🔀 Pull Requests

GET /api/repos/:owner/:repo/pulls List PRs
POST /api/repos/:owner/:repo/pulls Create PR
PUT /api/repos/:owner/:repo/pulls/:id/merge Merge PR

🔔 Webhooks

Configure webhooks in Repository → Settings → Webhooks.

Events

push Code pushed to repository
pull_request PR opened, closed, merged
issue Issue created or updated

Payload Example

{
  "event": "pull_request",
  "action": "opened",
  "repository": {"name": "project", "owner": "user"},
  "pull_request": {"number": 42, "title": "Add feature"}
}