---
title: "Get channel"
method: GET
path: "/v1/channels/{channel_id}"
tags: ["Channels"]
---

# Get channel

`GET /v1/channels/{channel_id}`

## Request

- Base URL: `https://dovetail.com/api`
- URL: `https://dovetail.com/api/v1/channels/{channel_id}`
- Auth: HTTP bearer

Retrieve a single channel's metadata by its unique identifier. Returns title, creation date, folder location, and a list of its topics (AI-generated categories used to classify incoming data points).

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

**Required scope:** `channel:read`

## Path parameters

- `channel_id` string, required

## Response `200`

200

- object
  - `data` object, required
    - `id` string, required
    - `url` string: The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `title` string, required
    - `type` 'channel', required
    - `created_at` string, required
    - `deleted` boolean, required
    - `folder` object, nullable, required
      - `id` string, required
    - `topics` object[], required
      - `id` string, required
      - `title` string, required
      - `description` string, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `422`: 422
- `429`: 429
- `500`: 500

## Changes

- **2026-11-03** `8abea327e6b9`: 4 breaking, 1 warning
  - added `subschema #1, subschema #2` to the `errors/items/` response property `oneOf` list for the response status `403`
  - the `errors/items/` response's property type changed from `object` to no type for status `403`
  - removed the required property `errors/items/code` from the response with the `403` status
  - removed the required property `errors/items/title` from the response with the `403` status
  - …1 more

[Operation history](https://skmtc.dev/dovetail/apis/dovetail-public-api/changes/v1/channels/:channel_id/get.md)

---

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