List files

GET /api/v1/repos/files

Enumerates every file at the requested reference to help you build navigation or quick comparisons.

GET /api/v1/repos/files?ref=BRANCH_OR_SHA
Authorization: Bearer YOUR_JWT_TOKEN

Parameters

Parameter	Type	Description
ref	Optional	Branch name or commit SHA. If not specified, uses the repository’s default branch
ephemeral	Optional	When true, resolves the ref under the ephemeral namespace

JWT Requirements

• The JWT must include the repository in the repo claim
• Requires git:read scope

Response

{
  "paths": ["README.md", "package.json", "src/index.js", "src/utils/helper.js"],
  "ref": "main"
}

Notes

• Returns all files in the repository at the specified ref
• Directories are not included in the list, only files
• File paths are relative to the repository root
• If no ref is specified, the repository’s default branch is used (typically main or master)
• paths: Array of file paths in the repository
• ref: The resolved reference (branch name or commit SHA) that was used

Error Responses

Status	Description
404 Not Found	Reference doesn’t exist
401 Unauthorized	Invalid JWT or missing git:read scope