Versions

Finalize a version

Compiles and activates an uploaded version. Waits for completion by default. Pass async=1 to get an operation handle to poll instead.

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

Request

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

Path parameters

spaceIdstring required
versionIdstring required

Query parameters

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

Finalize 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

channel'live' | 'production' nullable

Omit for live publish, use production as an alias for live, or pass null to finalize the version without promoting it.

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.