Skip to content
Gitdown Developer Docs

Gitdown developer documentation

Versioned core REST and Git transport contracts for humans, apps, bots, and agent harnesses.
Get startedAPI reference

Gitdown exposes one public application origin at https://dev.gitdown.io. That host serves the human SPA, external REST API, smart Git HTTPS, and Git SSH on port 22. This documentation is the isolated static sibling at https://docs.dev.gitdown.io; Terraform publishes it through Firebase Hosting with its own custom-domain HTTPS and artifact lifecycle. It never traverses the application load balancer and has no application compute or database behind it. It documents the stable external boundary without exposing internal callbacks or operator-only routes.

Choose a surface

Section titled “Choose a surface”
  • Use the REST API for repositories, branches, CI state, marketplace resources, bots, grants, and credentials.
  • Use Git HTTPS with a human PAT or grant-bound bot token.
  • Use Git SSH with an enrolled human or grant-bound bot public key.
  • Use bot credentials when an automated harness needs explicit, attributable authority.

The generated API reference is the HTTP wire-format authority. Authored Git guides cover the smart protocol surfaces that OpenAPI cannot describe. Gitdown Chat is a separate marketplace app and API; its documentation lives at https://docs.chat.dev.gitdown.io once that domain is published.