---
title: "List channels for a space"
method: GET
path: "/v1/spaces/{spaceId}/channels"
tags: ["Spaces"]
---

# List channels for a space

`GET /v1/spaces/{spaceId}/channels`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/spaces/{spaceId}/channels`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns each named channel for the space and where it currently points. Read-only.

## Path parameters

- `spaceId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object[], required
    - `name` string, required: Channel name; `live` is the default.
    - `currentVersionId` string, nullable, required: Version this channel currently serves, or null before first publish.
    - `currentDeploymentUrl` string, nullable: Immutable URL of the currently-served version, when known.
    - `previousVersionId` string, nullable: Last version this channel served before the current pointer (rollback target).
    - `promotion` 'auto' | 'manual', required: auto: publishes and green builds go live; manual: only explicit promotion moves the pointer.
    - `updatedAt` string, date-time, required: Instant this channel last changed: a pointer move or a promotion policy change. `lastChange.at` is the pointer-move instant alone.
    - `lastChange` object, nullable: The most recent pointer move from the promotion log, or null when none exists.
      - `kind` 'publish' | 'promote' | 'rollback', nullable, required: How the pointer moved, or null when the log entry predates kind recording.
      - `at` string, date-time, required: Instant the pointer moved, from the promotion log.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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