Versions

Start a new version upload

Creates a version and returns upload instructions. The declared file manifest drives change-only uploads: unchanged files are retained from the previous version and only the remainder is requested.

post/v1/spaces/{spaceId}/versions

Request

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

Path parameters

spaceIdstring required

Request body

publishMode'additive' | 'snapshot'

How to interpret omitted paths in files: additive retains existing paths unless explicitly replaced; snapshot treats files as the complete desired manifest.

sourceMetadataobject

Additional control-plane-only provenance for build and deploy read models.

buildLogstring

Build transcript truncated to a bounded size for deploys that ran a local build before publishing.

configOnlyboolean

Recompile the configuration on top of the current ready artifact without replacing content: the file catalog carries forward, Functions/Zero declarations and runtime detection are preserved, and the version records a config_update source. files may name only sf.jsonc (the shipped configuration); every other path keeps the current version's bytes. Requires an existing ready version to carry forward. Runtime changes still need a normal content publish.

deletePathsstring[]

Explicit paths to remove when publishMode is additive. Omitted paths are retained. Only listed paths are deleted.

immutableAssetPrefixesstring[]

Publisher-owned directory prefixes whose declared files are immutable generation assets. Snapshot publishes retain the matching files from the current generation for exactly one subsequent generation.

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.