---
title: "Set a channel's promotion policy"
method: PATCH
path: "/v1/spaces/{spaceId}/channels/{name}"
tags: ["Spaces"]
---

# Set a channel's promotion policy

`PATCH /v1/spaces/{spaceId}/channels/{name}`

## Request

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

auto (default): publishes and green builds go live. manual: builds and publishes finalize ready but unpromoted; only an explicit promote moves the pointer. Only the live channel is supported today.

## Path parameters

- `spaceId` string, required
- `name` string, required

## Request body

- object
  - `promotion` 'auto' | 'manual', required: Whether implicit promotion paths may move this channel's pointer.

## 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)