Get fork by UUID

Fetch the status of a specific fork operation by UUID.

Endpoint

GET /api/v1/forks/{fork_uuid}
Authenticated

Usage

curl --header "Authorization: Bearer $GHIT_API_TOKEN" \
  "$GHIT_API_URL/v1/forks/01958d9a-9d2c-7f40-b8ad-c1dd2f4cc3c0"

Call this after create-fork using the returned UUID. Access is checked against the upstream repo, so private fork status is only visible to users who can access the upstream repo.

Success

200 OK with the fork status record, including created_by_uuid and created_by_username.

{
  "uuid": "...",
  "created_at": "2026-03-09T12:00:00Z",
  "status": "completed"
}

Errors

  • 403 Forbidden when caller cannot access the upstream repo.
  • 404 Not Found when the fork UUID does not exist.

Common auth errors are documented on the API overview page.