---
title: "List a channel's promotion history"
method: GET
path: "/v1/spaces/{spaceId}/channels/{name}/history"
tags: ["Spaces"]
---

# List a channel's promotion history

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

## Request

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

Returns the channel.promoted activity log for the named channel, newest first. This is the deploy log.

## Path parameters

- `spaceId` string, required
- `name` 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
    - `versionId` string, required: Version the channel was promoted to.
    - `channel` string, required: Channel that moved.
    - `previousVersionId` string, nullable: Version the channel served immediately before this promotion.
    - `actorType` 'visitor' | 'user' | 'api_key' | 'partner_token' | 'oauth_client' | 'anonymous_claim' | 'system', nullable: Kind of actor that performed the promotion.
    - `actorId` string, nullable: Identifier of the promoting actor.
    - `kind` 'publish' | 'promote' | 'rollback', nullable: How the pointer moved, or null when the entry predates kind recording.
    - `at` string, date-time, required: Instant when the promotion happened.

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