0

Retrieves a single Channel by ID.

by
Published Oct 17, 2025

This endpoint retrieves a specific Channel given its ID.

Script clickup Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Clickup = {
3
  token: string;
4
};
5
/**
6
 * Retrieves a single Channel by ID.
7
 * This endpoint retrieves a specific Channel given its ID.
8
 */
9
export async function main(
10
  auth: Clickup,
11
  workspace_id: string,
12
  channel_id: string,
13
  description_format: "text/md" | "text/plain" | undefined,
14
) {
15
  const url = new URL(
16
    `https://api.clickup.com/api/v3/workspaces/${workspace_id}/chat/channels/${channel_id}`,
17
  );
18
  for (const [k, v] of [["description_format", description_format]]) {
19
    if (v !== undefined && v !== "" && k !== undefined) {
20
      url.searchParams.append(k, v);
21
    }
22
  }
23
  const response = await fetch(url, {
24
    method: "GET",
25
    headers: {
26
      Authorization: auth.token,
27
    },
28
    body: undefined,
29
  });
30
  if (!response.ok) {
31
    const text = await response.text();
32
    throw new Error(`${response.status} ${text}`);
33
  }
34
  return await response.json();
35
}
36