---
title: "List Channels"
method: GET
path: "/apps/{app_id}/channels"
---

# List Channels

`GET /apps/{app_id}/channels`

## Request

- Base URL: `https://api.xhostd.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xhostd.com/apps/{app_id}/channels`
- Auth: none declared

List the channels of one app the caller can reach.

The route only reads, so it runs on ``run_read_in_thread``. It costs
three round trips to the control DB: the access check, the channels,
and the pending deploy of every channel in one grouped statement.

## Path parameters

- `app_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ChannelResponse[]
  - `id` string, uuid, required
  - `name` string, required
  - `hostname` string, required
  - `git_ref_binding` string, nullable, required
  - `follows_branch` boolean, required
  - `current_sha` string, nullable, required
  - `status` string, required
  - `pending_deploy` PendingDeployResponse, required: The channel's in-flight deploy, if one is queued or running.
    - `deploy_id` string, uuid, required
    - `sha` string, required
    - `status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xhostd/apis/xhostd-public.md) · [All operations](https://skmtc.dev/xhostd/apis/xhostd-public/llms.txt) · [OpenAPI document](https://skmtc.dev/xhostd/apis/xhostd-public/revisions/bf439c4d1789?raw)