API Reference
Files
Browse directory trees and read file contents via the API.
List Directory
GET /v1/repos/:slug/tree/:ref/*pathThe :ref can be a branch name, tag, or commit SHA.
Response 200:
{
"items": [
{ "name": "src", "path": "src", "type": "folder", "sha": "a1c2...", "mode": "040000" },
{ "name": "README.md", "path": "README.md", "type": "file", "sha": "7f3b...", "mode": "100644" }
],
"path": "",
"ref": "main",
"sha": "d4e5..."
}Entry types are "folder" or "file".
Read File
GET /v1/repos/:slug/blob/:ref/*pathReturns the file content. Binary files are returned as base64. Max file size: 50 MB.
Response 200:
{
"content": "# Hello World\n",
"encoding": "utf-8",
"path": "README.md",
"sha": "7f3b...",
"size": 15
}Supports ETag / If-None-Match for caching.
List Refs
GET /v1/repos/:slug/refsReturns all branches and tags with their head SHAs:
{
"branches": [
{ "name": "main", "sha": "7f3b...", "type": "branch" }
],
"tags": [
{ "name": "v1.0", "sha": "a1c2...", "type": "tag" }
],
"default_branch": "main"
}