Documentation

REST API

GitForge exposes a git-native HTTP API. All endpoints are JSON, dates are ISO 8601, and lists are paginated with limit/offset.

Authentication

Pass a personal access token as a bearer token:

curl https://your-host/repos \
  -H "Authorization: Bearer gf_YOUR_TOKEN"

Repositories

GET    /repos                      list repositories
POST   /repos                      create a repository
GET    /repos/:owner/:repo/resolve resolve owner/repo to an id
GET    /repos/:id                  repository detail
PATCH  /repos/:id                  update
DELETE /repos/:id                  delete

Pull requests & issues

GET  /repos/:id/pulls              list pull requests
POST /repos/:id/pulls              open a pull request
GET  /repos/:id/pulls/:number      pull request detail
GET  /repos/:id/issues             list issues
POST /repos/:id/issues             open an issue

Pagination

Paginated responses return { data, total, limit, offset, hasMore }. Some endpoints return a bare array where pagination does not apply.