Hanzo AIDocs
Sign inAPI key

List branches

Lists a repository's branches, the default first, with prefix search.

GET /v1/provider/github/repos/{owner}/{repo}/branches

Provider → · All API references → · Get started →

Addresshttps://api.hanzo.ai/v1/provider/github/repos/{owner}/{repo}/branches
MethodGET
Operationget_provider_github_repos_by_owner_by_repo_branches
AuthAuthorization: Bearer $HANZO_API_KEY

Lists a repository's branches, the default first, with prefix search. The repository must be one the caller may see — the same set GET /v1/provider/github/repos lists — or it is 404.

Request

5 fields.

FieldInTypeRequiredDescription
ownerpathstringyesOwner is the GitHub account that holds the repository.
repopathstringyesRepo is the repository's name within that account.
qquerystring—Q keeps branches whose name starts with it, matched by GitHub.
limitqueryinteger—Limit is the page size: 1 to 100, and 50 when absent or unreadable.
afterquerystring—After is the next of the previous page.

Response

StatusBodyMeaning
200provider.githubBranchesOutok
defaultproblem-detailsrefused

200 body — 6 fields.

FieldInTypeAlwaysDescription
branchesbodyprovider.githubBranch[]—Branches is this page: the default branch first, then the rest by name.
branches[].commitbodystring—Commit is the sha the branch points at.
branches[].defaultbodyboolean—Default is whether it is the repository's default branch, which always leads the first page when it matches.
branches[].namebodystring—Name is the branch's short name ("main", "feat/login").
nextbodystring—Next is the cursor for the page after this one; empty on the last page.
totalbodyinteger (int64)—Total is how many branches match q, across every page.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.

import { Configuration, ProviderApi } from 'hanzoai';

const api = new ProviderApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getProviderGithubReposByOwnerByRepoBranches({ owner: 'owner', repo: 'repo' });
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import ProviderApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = ProviderApi(client).get_provider_github_repos_by_owner_by_repo_branches(owner='owner', repo='repo')
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.ProviderAPI.GetProviderGithubReposByOwnerByRepoBranches(context.Background()).Execute()
if err != nil {
	return err
}
use hanzo_client::apis::{configuration::Configuration, provider_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = provider_api::get_provider_github_repos_by_owner_by_repo_branches(&cfg, Default::default()).await?;
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.ProviderApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new ProviderApi(client).getProviderGithubReposByOwnerByRepoBranches();
curl https://api.hanzo.ai/v1/provider/github/repos/<owner>/<repo>/branches \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP reaches provider through the provider tool, which names its 38 operations with its own verbs — this one among them, under a name only MCP 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": "list_connections"
         }
       }
     }'

Provider API · All Hanzo APIs · Interactive reference

Was this page useful?
PreviousList installationsNextList pages