← API reference
Mutation / surfaces

upsertWorkspace

Create a workspace or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require workspace:write.

Arguments

The definition (which carries the handle) plus optional scope / team assignments.

Returns WorkspacePayload!

Explore in a view

Journeys and Workspaces
View exact SDL
"""
Create a workspace or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require workspace:write.
"""
upsertWorkspace(
  """
  The definition (which carries the handle) plus optional scope / team assignments.
  """
  input: UpsertWorkspaceInput!
): WorkspacePayload! @topic(names: ["surfaces"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.