Versions

Promote a version

Promotes a ready version to a channel (live by default). Use this for rollback: promote any earlier ready version. Waits for completion by default. Pass async=1 to get an operation handle to poll instead.

post/v1/spaces/{spaceId}/versions/{versionId}/promote

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/spaces/{spaceId}/versions/{versionId}/promote
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

spaceIdstring required
versionIdstring required

Query parameters

async'0' | '1' | 'true' | 'false'

Promote in the background and return the operation handle instead of waiting (true/1).

Headers

Idempotency-Keystring

Optional client-generated key, at most 255 characters, that makes this write safe to retry. The first request with a given key stores its outcome, scoped to your tenant, credential, and route. A retry with the same key and an identical body does not execute again: the server replays the stored response and marks it Idempotency-Replayed: true. A request that reuses a key with a different body fails with 409 idempotency_key_reused. A duplicate request that arrives while the first is still in flight fails with 409 idempotency_conflict_in_progress. The server keeps each key for 24 hours.

Request body

channelstring

Channel to point at this version. Defaults to "live". Non-live channel names are rejected with channel_unsupported until additional channels ship.

Response

Response for status 200

$schemastring uri

Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

Changes

No recorded changes to this operation across all 1 revision of this API.