Space Tools

Read the saved editor and public version without initializing a Space. Content and gallery edits on a published Space stay in its draft. The check-in method changes immediately. The Space data request is a ceiling, not member consent. Preview publication, unpublication, discarding drafts, data requests and slug changes, then ask for explicit approval before confirm_workspace_action.

Use list_workspaces to choose a workspace. The schemas returned by tools/list describe the deployed version.

get_space

Read the saved Space editor, its public version, slug and check-in method. Does not initialize, repair or enrich a Space. Published Spaces may carry a separate unpublished draft. Requires Space access.

Permission: space:read. workspaceId is required.

get_space_data_sharing

Read the Space's live and draft data request and supported categories, without changing anything. This is the request ceiling, not any member's consent; members choose their own sharing.

Permission: space:read. workspaceId is required.

update_space_content

Save specified Space content fields using the editor's validation. On a published Space, edits stay in the unpublished draft. Does not publish, change the data request or slug. Use prepare_space_publish to preview publication.

Permission: space:write. workspaceId is required.

Parameter	Notes
content	Required. Only fields to change: displayName, logoUrl, tagline, description, overview, address, placeId, geo, brandColor, ground, groundColor, focusTags, links, quickActions, sections, peakHours

add_space_gallery_image

Import one image from the workspace Library or approved Bank source into the Space gallery. Uses the editor's ownership checks, image validation and gallery limit. On a published Space the image stays in the draft until approved publication.

Permission: space:write. workspaceId is required.

Parameter	Notes
sourceUrl	Required. Image sourceUrl from the Library or Bank

set_space_check_in_method

Change how members check in: front_desk, qr, or self. This operating setting takes effect immediately, independently of the content draft. Owner/admin only; also requires permission to edit Space.

Permission: space:write. workspaceId is required.

Parameter	Notes
method	Required. front_desk, qr, or self

prepare_space_publish

Preview publishing the saved Space draft, with before/after content and effects. Writes no Space data. Show the preview and ask for explicit approval, then use confirm_workspace_action. If the Space changes meanwhile, prepare again.

Permission: space:publish. workspaceId is required.

prepare_space_unpublish

Preview hiding the public Space and clearing its unpublished draft. The join code stays reserved for republishing. Writes no Space data. Show the effects and ask for explicit approval, then use confirm_workspace_action.

Permission: space:publish. workspaceId is required.

prepare_space_discard_draft

Preview dropping the Space's saved unpublished changes and returning to the public version. Nothing is discarded yet. Show the preview, ask for explicit approval, then use confirm_workspace_action.

Permission: space:write. workspaceId is required.

prepare_space_data_request

Preview replacing the Space's data request. Narrowing removes member access immediately when confirmed; the editor's draft/publish rules still apply. Does not grant member consent. Show the effects, ask for explicit approval, then use confirm_workspace_action.

Permission: space:write. workspaceId is required.

Parameter	Notes
requestedScopes	Required. Category to {mode: all|selected|none, items?: string[]}; categories come from get_space_data_sharing. Only metrics, profile, biomarkers and modules support selected mode. Workouts, nutrition, goals and labs support only all or none.

prepare_space_slug

Preview claiming or changing the Space public slug. Owner/admin only. Checks availability but does not reserve it until confirmation. Show the address change and redirect effect, ask for explicit approval, then use confirm_workspace_action.

Permission: space:write. workspaceId is required.

Parameter	Notes
slug	Required. Desired public slug