GitForge
Sign inGet started
Documentation

API explorer

The full REST API surface, generated from the live OpenAPI spec and grouped by resource. Authenticate with a personal access token as a bearer token.

admin

  • DELETE/admin/repos/{id}Admin delete a repository
  • POST/admin/repos/{id}/clear-git-dataClear Git data for a repository
  • POST/admin/tenant/reconcile-storageTenant-wide storage ↔ DB content-addressed reconcile
  • POST/admin/outbox/drain-orphansDrain event_outbox entries referencing deleted repos
  • POST/admin/repos/{id}/reconcileReconcile pack_index ↔ S3 consistency for a single repo
  • GET/admin/logsRead aggregated service logs from Redis Streams
  • GET/admin/repos/{id}/footprintFull DB + S3 footprint of a repo (diagnostic / cleanup proof)

agent sessions

  • POST/agent/sessionsCreate an agent session
  • GET/agent/sessionsList agent sessions
  • GET/agent/sessions/{id}Get an agent session by ID
  • DELETE/agent/sessions/{id}Disconnect an agent session
  • POST/agent/sessions/{id}/heartbeatSend a heartbeat for an agent session
  • POST/agent/sessions/{id}/activityLog an activity event for an agent session
  • GET/agent/activityList agent activity across all sessions

auth

  • GET/auth/meGet current user
  • PATCH/auth/meUpdate current user profile
  • POST/auth/me/usernameRename current user's username
  • GET/auth/me/editor-preferencesGet editor preferences
  • PATCH/auth/me/editor-preferencesUpdate editor preferences
  • GET/auth/pats/scopesList available PAT scopes
  • POST/auth/patsCreate a Personal Access Token
  • GET/auth/patsList Personal Access Tokens
  • DELETE/auth/pats/{id}Revoke a Personal Access Token

batch

  • POST/batch/diffGet diffs across multiple repos

branches

  • GET/repos/{id}/branchesList branches

commits

  • GET/repos/{id}/commitsList commit history
  • GET/repos/{id}/compareCompare two branches or commits
  • GET/repos/{id}/compare/diffGet full diff between two branches or commits
  • GET/repos/{id}/commits/{sha}/diffGet diff for a single commit

explore

  • GET/explore/patch-setsBrowse public patch sets

files

  • GET/repos/{id}/tree/{ref}Browse repository tree
  • GET/repos/{id}/blob/{ref}Get file content
  • GET/repos/{id}/raw/{ref}Get raw file content
  • GET/repos/{id}/archive/tarball/{ref}Download repository archive as tarball

index

  • POST/repos/{id}/index/syncIndex files for semantic search
  • POST/repos/{id}/index/searchSemantic search over indexed chunks

org tokens

  • GET/org/tokensList organization access tokens
  • POST/org/tokensCreate an organization access token
  • GET/org/tokens/{id}Get organization access token details
  • DELETE/org/tokens/{id}Revoke an organization access token

patch sets

  • POST/patch-sets/{id}/publishPublish a patch set (make public)
  • DELETE/patch-sets/{id}/publishUnpublish a patch set (make private)
  • GET/patches/{owner}/{setName}View a public patch set
  • POST/patch-sets/{id}/forkFork a public patch set into your account
  • POST/patch-sets/{id}/subscribeSubscribe to upstream updates on a forked patch set
  • DELETE/patch-sets/{id}/subscribeUnsubscribe from upstream updates
  • GET/patch-sets/{id}/updatesCheck for upstream updates on a subscribed patch set
  • POST/patch-sets/{id}/updates/acceptAccept upstream updates into a subscribed patch set

patches

  • POST/patch-setsCreate a patch set
  • GET/patch-setsList patch sets
  • GET/patch-sets/{id}Get a patch set
  • PATCH/patch-sets/{id}Update a patch set
  • DELETE/patch-sets/{id}Delete a patch set
  • POST/patch-sets/{id}/patchesAdd a patch to a patch set
  • PATCH/patch-sets/{id}/patches/{patchId}Update a patch
  • DELETE/patch-sets/{id}/patches/{patchId}Remove a patch from a patch set
  • POST/patch-sets/{id}/materializeMaterialize a patch set
  • POST/patch-sets/{id}/extract-from-commitsExtract commits as patches

pull requests

  • GET/pullsList pull requests across all repos for the authenticated user
  • POST/repos/{id}/pullsCreate a pull request
  • GET/repos/{id}/pullsList pull requests
  • GET/repos/{id}/pulls/{number}Get a pull request
  • PATCH/repos/{id}/pulls/{number}Update a pull request
  • GET/repos/{id}/pulls/{number}/versionsList pull request versions
  • PATCH/repos/{id}/pulls/{number}/visibilitySet pull request visibility
  • POST/repos/{id}/pulls/{number}/mergeMerge a pull request
  • POST/repos/{id}/pulls/{number}/closeClose a pull request
  • GET/repos/{id}/pulls/{number}/reviewsList pull request reviews
  • POST/repos/{id}/pulls/{number}/commentsAdd a comment to a pull request
  • GET/repos/{id}/pulls/{number}/commentsList pull request comments
  • GET/repos/{id}/pulls/{number}/checksList pull request status checks
  • GET/repos/{id}/pulls/{number}/diffGet pull request diff
  • GET/repos/{id}/pulls/{number}/diff/streamStream pull request diff
  • GET/repos/{id}/pulls/{number}/versions/{version}/diffGet pull request version diff
  • GET/repos/{id}/pulls/{number}/filesList changed files in a pull request

repos

  • POST/reposCreate a repository
  • GET/reposList repositories
  • POST/repos/batchBatch create repositories
  • DELETE/repos/batchBatch delete repositories
  • PATCH/repos/batchBatch update repositories
  • GET/repos/{id}Get a repository
  • PATCH/repos/{id}Update repository settings
  • DELETE/repos/{id}Delete a repository
  • POST/repos/{id}/diff-commitCreate a commit from a unified diff patch
  • POST/repos/{id}/forkFork a repository
  • POST/repos/{id}/transferTransfer repository to another tenant
  • DELETE/repos/{id}/baseDetach repository from its upstream fork parent
  • POST/repos/{id}/pull-upstreamSync fork with upstream repository
  • POST/repos/{id}/restore-commitRestore a branch to a historical commit's tree state
  • POST/repos/{id}/notesCreate or append a git note on a commit
  • GET/repos/{id}/notes/{sha}Get git note for a commit
  • DELETE/repos/{id}/notes/{sha}Delete a git note from a commit
  • GET/repos/{id}/files/metadataList all files with per-file metadata and last-commit attribution

search

  • GET/search/code/facetsGet search facets/filters
  • GET/search/codeSearch code across repositories
  • GET/repos/{id}/searchSearch code within a repository
  • POST/repos/{id}/search/reindexTrigger search reindexing for a repository
  • GET/repos/{id}/search/statusGet search index status for a repository

stacks

  • GET/stacksList PR stacks
  • POST/stacksCreate a new PR stack
  • GET/stacks/{id}Get a stack by ID
  • PATCH/repos/{id}/pulls/{number}/stackAssign a PR to a stack
  • POST/stacks/{id}/restackRestack pull requests

tags

  • GET/repos/{id}/tagsList tags

traverse

  • GET/traverse/reposList repositories available for traversal
  • GET/traverse/{repoId}Traverse a repository's file tree
  • GET/traverse/{repoId}/impactAnalyze change impact across a repository

webhooks

  • POST/repos/{id}/webhooksCreate a webhook
  • GET/repos/{id}/webhooksList webhooks
  • DELETE/repos/{id}/webhooks/{webhookId}Delete a webhook