0

List available major cluster versions

by
Published Oct 17, 2025

Sort order: Version number descending This endpoint may be used by any member of the organization.

Script cockroachdb Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Cockroachdb = {
3
  token: string;
4
};
5
/**
6
 * List available major cluster versions
7
 * Sort order: Version number descending
8

9
This endpoint may be used by any member of the organization.
10
 */
11
export async function main(
12
  auth: Cockroachdb,
13
  pagination_page: string | undefined,
14
  pagination_limit: string | undefined,
15
  pagination_as_of_time: string | undefined,
16
  pagination_sort_order: "ASC" | "DESC" | undefined,
17
) {
18
  const url = new URL(`https://cockroachlabs.cloud/api/v1/cluster-versions`);
19
  for (const [k, v] of [
20
    ["pagination.page", pagination_page],
21
    ["pagination.limit", pagination_limit],
22
    ["pagination.as_of_time", pagination_as_of_time],
23
    ["pagination.sort_order", pagination_sort_order],
24
  ]) {
25
    if (v !== undefined && v !== "" && k !== undefined) {
26
      url.searchParams.append(k, v);
27
    }
28
  }
29
  const response = await fetch(url, {
30
    method: "GET",
31
    headers: {
32
      Authorization: "Bearer " + auth.token,
33
    },
34
    body: undefined,
35
  });
36
  if (!response.ok) {
37
    const text = await response.text();
38
    throw new Error(`${response.status} ${text}`);
39
  }
40
  return await response.json();
41
}
42