Returns every file a glob selects at one revision, WITH its bytes and the…
Returns every file a glob selects at one revision, WITH its bytes and the revision they came from.
GET /v1/git/repos/{name}/files
| Address | https://api.hanzo.ai/v1/git/repos/{name}/files |
| Method | GET |
| Operation | get_git_repos_by_name_files |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Returns every file a glob selects at one revision, WITH its bytes and the revision they came from. It is the read a delivery generator makes: one call answers "what is the inventory at this commit, and what does it say", where listing and then fetching would be a request per file.
Returning the resolved revision matters as much as the bytes. A generator that
lists at main and then reads at main can straddle a push and assemble half
its inventory from one commit and half from the next; resolving once makes the
whole read consistent by construction.
A file past the read cap comes back Truncated with no content rather than being dropped. A caller building a desired set has to know the difference between "this file is empty" and "this file was not read" — silently omitting it is how a pruning reconcile deletes what the missing file declared.
Request
3 fields.
| Field | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | Name is the repo to read, from the :name path segment. |
ref | query | string | — | Ref is a branch, tag or commit; empty means the repo's HEAD. |
glob | query | string | — | Glob selects files, matched segment by segment so * never crosses a /. |
Response
| Status | Body | Meaning |
|---|---|---|
200 | filesJSON | ok |
200 body — 7 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
files | body | fileJSON[] | — | Files are the selected files, sorted by path. |
files[].content | body | string | — | Content is the file's bytes, empty when Truncated. |
files[].encoding | body | string | — | Encoding is how Content is carried: "utf8" verbatim, or "base64". |
files[].path | body | string | — | Path is the file's repo-relative path. |
files[].size | body | integer | — | Size is the file's byte length in the repo. |
files[].truncated | body | boolean | — | Truncated marks a file past the read cap; no content is sent. |
rev | body | string | — | Rev is the full revision the ref resolved to — pin follow-up reads to it. |
Failure carries the platform error shape — see Errors.
Examples
hanzo git repos files <name>import { Configuration, GitApi } from 'hanzoai';
const api = new GitApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getGitReposByNameFiles({ name: 'name' });from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import GitApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = GitApi(client).get_git_repos_by_name_files(name='name')cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)
resp, _, err := client.GitAPI.GetGitReposByNameFiles(context.Background()).Execute()
if err != nil {
return err
}use hanzo_cloud::apis::{configuration::Configuration, git_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = git_api::get_git_repos_by_name_files(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.GitApi;
ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));
var result = new GitApi(client).getGitReposByNameFiles();curl https://api.hanzo.ai/v1/git/repos/<name>/files \
-H "Authorization: Bearer $HANZO_API_KEY"The door reaches git through the git tool, which names its 56 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:
curl -X POST https://api.hanzo.ai/v1/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "describe",
"arguments": {
"op": "get_git"
}
}
}'How is this guide?