Skip to main content
Glama

update_workspace

Rename a workspace, change its slug, switch its default-view mode, or change its visibility (private | org). Pass any subset of name, new_slug, mode, visibility; fields you omit are left unchanged. Slug renames preserve old URLs via WorkspaceSlugAlias so previously-shared links keep resolving. Visibility flips disconnect every live SSE subscriber so reconnects re-authenticate against the new visibility. Editor role required; only the workspace owner can change visibility. Emits workspace.renamed and/or workspace.visibility_changed. Visibility WIDENING (private → org) is consent-gated: pass consent_mode: "web" to return an approval_url the user clicks; otherwise the call returns consent_required and you must re-issue with consent_mode set. Narrowing (org → private) and non-visibility updates execute immediately.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modeNoNew default-view preference for the surface that opens first. Optional. Doesn't add or remove surfaces; use `create_surface` / `delete_surface` to change the actual surfaces.
nameNoNew display name. Optional.
slugYesThe current workspace slug
new_slugNoNew URL slug (lowercase kebab-case, 3-64 chars). Optional. Must be unique within the org. Old slug stays redirectable via the alias table.
visibilityNoNew visibility. Optional. `private` = explicit members only; `org` = every org member gets virtual editor. Only these two can be set. Widening (private → org) is consent-gated; see `consent_mode`.
consent_modeNoRequired when `visibility` widens audience. Pass 'web' to surface a click-to-approve URL the user opens in their browser; first call returns { status: 'approval_required', approval_url, polling_url }, you print approval_url in chat and poll polling_url for the result.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / mode / description
      Previous value: -"New default-view preference for the workspace's first tab. Optional. Doesn't add or remove surfaces; use `create_surface` / `delete_surface` to change the actual tab set."New value: +"New default-view preference for the surface that opens first. Optional. Doesn't add or remove surfaces; use `create_surface` / `delete_surface` to change the actual surfaces."
    • changedInput schema / properties / visibility / description
      Previous value: -"New visibility. Optional. `private` = explicit members only; `org` = every org member gets virtual editor; `unlisted` = anyone with the URL can view; `public` = listed and viewable to all. Widening transitions are consent-gated; see `consent_mode`."New value: +"New visibility. Optional. `private` = explicit members only; `org` = every org member gets virtual editor. Only these two can be set. Widening (private → org) is consent-gated; see `consent_mode`."
    • changedInput schema / properties / visibility / enum
      Previous value: -[
      -  "private",
      -  "org",
      -  "unlisted",
      -  "public"
      -]New value: +[
      +  "private",
      +  "org"
      +]
  2. Changed1 schema field changed
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "table",
      -  "doc"
      -]New value: +[
      +  "table",
      +  "doc",
      +  "html"
      +]
  3. Changed1 schema field changed
    • changedInput schema / properties / mode / description
      Previous value: -"New default-view preference for the workspace's first tab. Optional. Doesn't add or remove surfaces — use `create_surface` / `delete_surface` to change the actual tab set."New value: +"New default-view preference for the workspace's first tab. Optional. Doesn't add or remove surfaces; use `create_surface` / `delete_surface` to change the actual tab set."
  4. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.