← All types

WorkspaceVersion

One immutable version of a workspace's definition. Versions form the authoring history; listWorkspaceVersions returns them newest first.

Fields

TypeID of this immutable version record (prefix wsv, e.g. "wsv_01K…").

TypeID of the workspace this version belongs to (prefix wks).

version

Int!Non-null

Sequential version number within the workspace, starting at 1 and incrementing per authored draft.

DRAFT while this version is still being authored; PUBLISHED once publishWorkspace promotes it. Several DRAFT versions may be open at once — editing a workspace amends the newest, while createWorkspaceVersion always mints another — and publishing promotes the one it names, leaving the rest open.

Possible values (2)
DRAFT

An unpublished version; ordinary drafts are editable while IaC source snapshots are fixed. Never served to runners. On the workspace record it means no published version exists yet.

PUBLISHED

An immutable, live version — the only status runners fetch. On the workspace record it means a live published version exists, even when a newer draft is open beside it.

Internal compiled rendering contract.

source

StringNullable

Exact XML/Lua source envelope for this author-only version.

ISO-8601 timestamp when this version was authored (not when it was published).

Referenced by (3)
Exact type SDL
"""
One immutable version of a workspace's definition. Versions form the authoring history; `listWorkspaceVersions` returns them newest first.
"""
type WorkspaceVersion @iac_resource(name: "workspace_version") @iac_replace(strategy: CREATE_BEFORE_DESTROY) @iac_guide(ref: "workspace-authoring-guide") @iac_ops(create: "createWorkspaceVersionSnapshot", read: "getWorkspaceVersion", delete: "deleteWorkspaceVersionIfExists") {
  """
  TypeID of this immutable version record (prefix `wsv`, e.g. "wsv_01K…").
  """
  id: WorkspaceVersionID! @iac_identity(assignedBy: SERVER) @iac_computed
  """TypeID of the workspace this version belongs to (prefix `wks`)."""
  workspaceId: WorkspaceID! @iac_ref(resource: "workspace", onTargetDelete: CASCADE) @iac_forcesReplace
  """
  Sequential version number within the workspace, starting at 1 and incrementing per authored draft.
  """
  version: Int! @iac_computed
  """
  DRAFT while this version is still being authored; PUBLISHED once `publishWorkspace` promotes it. Several DRAFT versions may be open at once — editing a workspace amends the newest, while `createWorkspaceVersion` always mints another — and publishing promotes the one it names, leaving the rest open.
  """
  status: WorkspaceStatus! @iac_computed
  """Internal compiled rendering contract."""
  definition: String! @iac_computed
  """Exact XML/Lua source envelope for this author-only version."""
  source: String @iac_forcesReplace @iac_artifact(language: JSON, validators: ["workspace-source", "workspace-source-structure"], models: ["workspace_document"], modelPath: "/sourceXML", description: "Workspace source, including its document and server Lua.") @iac_guide(ref: "workspace-authoring-guide")
  """
  ISO-8601 timestamp when this version was authored (not when it was published).
  """
  createdAt: ISO8601! @iac_computed
}