---
title: "Cli List Branches"
method: GET
path: "/v1/cli/branches"
tags: ["v1-cli"]
---

# Cli List Branches

`GET /v1/cli/branches`

## Request

- Base URL: `https://api.tryardent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tryardent.com/v1/cli/branches`
- Auth: none declared

List branches for CLI user's current connector.

connector_id is required — scopes branches to a specific connector.
reveal_urls includes full connection URLs in the bulk response; hidden by default.

## Query parameters

- `connector_id` string, nullable
- `branch_id` string, nullable
- `branch_name` string, nullable
- `reveal_urls` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `a0512915b997`: 1 info
  - added the new optional `query` request parameter `reveal_urls`

[Operation history](https://skmtc.dev/tryardent/apis/tryardent-api/changes/v1/cli/branches/get.md)

---

[API](https://skmtc.dev/tryardent/apis/tryardent-api.md) - [All operations](https://skmtc.dev/tryardent/apis/tryardent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tryardent/apis/tryardent-api/revisions/a0512915b997?raw)
