---
title: "Get all channels"
method: GET
path: "/channels"
tags: ["Channel Operations"]
---

# Get all channels

`GET /channels`

Get all the channel developer branches in the brXM instance. <br/> If the returned list is empty, it means that there are no developer projects linked to any channel. It may be necessary to create a developer project or to link an existing developer project to a channel

## Response `200`

OK

- Channel[]
  - `id` string — identifier for a specific channel branch; constructed as "<channel name>-<channel branch>"
  - `name` string, required — identifying name of a channel
  - `projectName` string, required — channel's project name
  - `branch` string — name of the channel branch
  - `branchOf` string — name of channel branch this branch is branched from (if branched)
  - `externalPreviewEnabled` boolean — External preview flag
  - `externalPreviewToken` string — External preview token
  - `updateComponentContentOnPageSync` boolean — The default value of updateContentOnPageSync property on page specific component instances in pages, which identifies if the content of the component instance as a target page will be overwritten with the content from the soure page in page synchronization.
  - `contentRootPath` string, required — the (repository) content path (as child of /content) to be used as base content path for this channel; cannot be (only) /
  - `icon` string — the icon used to identify the channel, stored as a Data URL (data:[<mediatype>][;base64],<data>)
  - `locale` string — (content) locale to be used and assumed for this channel
  - `devices` string[] — names and width of supported delivery tier 'devices' to choose from for the Channel Manager (preview) rendering
  - `defaultDevice` string — name of the default 'device' to use by default for the Channel Manager (preview) rendering, defaults to "default" if not configured
  - `responseHeaders` object — optional response headers to provide on a (PMA) response
  - `linkurlPrefix` string — The prefix to prepend to links when the Channel PMA is accessed through a reverse proxy
  - `cdnHost` string — The CDN to use (where applicable and possible)
  - `remoteHostProtection` boolean — Whether remote host protection is enabled
  - `parameters` object — a map of parameters (names/values) for this Channel

## Other responses

- `403` — Forbidden

---

[API](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0.md) · [All operations](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bloomreach/documents-delivery-api-2-0/revisions/87bfc06578c2/schema)