Forgejo API Proxy

Extends Forgejo with a canonical proxy API surface under /api/v1 — including Actions logs, enriched job timings, Projects management, commit search, and more.

Swagger UI ReDoc

Quick Start

The proxy runs alongside your Forgejo instance. Authenticate using your existing Forgejo token:

curl -H 'Authorization: token YOUR_TOKEN' \
  'https://forgejo-proxy.hochguertel.work/api/v1/repos/owner/repo/actions/runs/latest/logs'

Canonical API shape

Treat Forgejo Proxy as the default HTTP surface for this ecosystem:

API resources live under /api/v1/...
/health stays rooted, and ActivityPub keeps rooted public federation URLs while the runtime also accepts /api/v1/activitypub/... aliases for API clients
thfg api takes a path relative to /api/v1
thfg activitypub is the dedicated client for the canonical ActivityPub aliases

Start here if you are updating older scripts: Migrate to the normalized /api/v1 API surface →

What’s Extended

Feature	Why extended?
Actions	Forgejo has no REST API for run logs — the proxy scrapes the web UI
Issues / PRs	Lock/unlock endpoints missing from Forgejo 14.x REST API
Commits	Full-text search across commit messages, authors, and SHAs
Projects	Forgejo has no Projects REST API at all — fully scraped from web UI

`thfg` CLI — 50+ commands

The thfg CLI covers the full Forgejo surface: issues, PRs, repos, orgs, workflows, variables, secrets, and more — all in a gh-style interface that auto-detects your repo from git remote.

Command group	Highlights
`thfg issue`	list/create/edit, comments, deadlines, reactions, timeline, attachments, pin/unpin, blocking/deps, time tracking
`thfg pr`	list/create/edit/merge, reviews, auto-merge, update, find by branch
`thfg repo`	edit, topics, collaborators, teams, hooks, branch/tag protection, wiki, push-mirrors, transfer
`thfg org`	members, labels, teams, hooks, blocking, rename
`thfg run` / `thfg workflow`	list, jobs, logs, summary, diagnose, performance
`thfg variable` / `thfg secret`	repo and org scope
`thfg activitypub` / `thfg api`	canonical ActivityPub aliases, raw `/api/v1` escape hatch, and spec access
`thfg api spec`	view the full proxy OpenAPI spec

See the CLI family reference →

Explore the Docs

CLI Reference

Family-level thfg reference plus links to the generated command inventory and CLI-to-API coverage pages. Read more →

Authentication

Learn how to authenticate requests using Authorization headers or token query params. Read more →

Actions Extensions

Fetch run logs, inspect enriched jobs and per-step timings, get summaries, and trigger reruns via REST. Read more →

Issues & PRs

Lock and unlock issues and pull requests programmatically. Read more →

Projects

Full CRUD for Forgejo Projects — columns, cards, org and repo projects. Read more →

Multi-Instance Support

Use thfg with Codeberg, gitea.io, or any self-hosted Forgejo instance simultaneously. Read more →

/api/v1 Normalization

Update older automation to the normalized proxy contract and learn the remaining root-path exceptions. Read more →