UpsertWorkspaceInput

Type: Input

Input for upsertWorkspace: create a workspace or overwrite its open draft, keyed on the handle inside definition.

Fields

Name	Type	Default	Description
definition	String!		The whole workspace as a verbatim JSON document (spec workspace-v1). The handle is derived from definition.id — the workspace with that handle is created, or its open draft overwritten. Validated server-side before storage.
scope	WorkspaceScope		Distribution scope to apply. Defaults to INSTANCE on create when omitted; keeps the existing scope on update. TEAM/INSTANCE require workspace:write; PERSONAL (owned by the caller) is self-service.
teamIds	[TeamID!]		TypeIDs (prefix tea) of the teams to assign; ignored unless scope is TEAM. Replaces the current assignments, so omitting it clears them — and a TEAM-scoped workspace must end up with at least one existing team.