Region: If more than one squaredup-* server is connected, ask the user which one they mean before running any tools, then use that same server for every SquaredUp tool call in the task.
Managing SquaredUp workspaces
Workspaces are the top-level grouping unit inside a SquaredUp tenant. Each workspace typically represents a team, product, environment, or business area, and groups its own dashboards, KPIs, and scope. Most read-side discovery (just listing what exists) is covered by the explore-org skill - this skill is for the write-side operations and the deeper config inspection of individual workspaces.
Tool map
| Tool |
What it does |
workspace_list |
List all workspaces in the tenant - id, displayName, type. Returns the workspaces visible to the caller. |
workspace_get |
Full single-workspace read - name, description, type, links. Returns null if not found / no access. |
workspace_create |
Create a new workspace. Body must include displayName; other fields optional. |
workspace_update |
Update an existing workspace. Full overwrite - read with workspace_get first. |
Standard workflow: create a workspace
workspace_create({
body: {
displayName: 'QA Environment',
description: 'Quality assurance team and tests',
},
});
// → { id: "space-..." }
The new workspace's id is returned in the response. Optional fields like description, type, and links can be passed alongside displayName. The schema is open (passthrough) so the API accepts any additional fields the user provides.
Standard workflow: update a workspace (rename, description, etc.)
workspace_update is a full overwrite, not a patch. Always:
workspace_get(workspaceId) - read the current body.- Mutate the field the user asked for.
workspace_update({ workspaceId, body: <mutated body> }).
const current = await workspace_get({ workspaceId: 'space-abc123' });
const updated = { ...current, displayName: 'QA Environment (renamed)' };
await workspace_update({ workspaceId: 'space-abc123', body: updated });
Standard workflow: inspect a workspace's full config
workspace_get(workspaceId) returns the full config - description, type (the user-facing workspace type, e.g. team, application, environment), links, and alertingRules. Use this when the user asks "what's in the X workspace's settings" rather than "what's inside the X workspace" (which would be dashboard_list filtered by workspaceId - see dashboards).
Common mistakes
- Calling
workspace_update with a partial body - it's a full overwrite. workspace_get first, mutate, then update. Sending only the changed field will wipe everything else.
- Confusing "the workspace exists" (returned by
workspace_list) with "I can read its config" (workspace_get may return null for access-controlled workspaces).
- Reaching for
workspace_get when the user actually wants the contents of the workspace - that's dashboard_list filtered by workspaceId.
- Creating a duplicate workspace by skipping
workspace_list first - if uniqueness matters, confirm no workspace with the same displayName exists before workspace_create.
When to skip this skill
- The user wants to list workspaces alongside other tenant resources (data sources, dashboards) →
explore-org.
- The user wants the dashboards / tiles / KPIs inside a workspace →
dashboards / kpis.
- The user wants to duplicate an existing workspace as a template for a new one →
clone-workspace.
- The user wants to manage who can access a workspace →
permissions.
- The user is performing graph traversal that starts from a workspace node →
query-graph (workspaces are type: 'space' graph vertices).
1---2name: workspaces3description: Use when the user wants to set up, rename, inspect, or manage SquaredUp workspaces - creating a new workspace for a team, reading a workspace's full settings, updating display names or descriptions. Trigger phrases include "create a workspace", "rename my workspace", "show me the X workspace's settings", "set up a workspace for the QA team", "update the workspace description".4---56> **Region:** If more than one `squaredup-*` server is connected, ask the user which one they mean before running any tools, then use that same server for every SquaredUp tool call in the task.78# Managing SquaredUp workspaces910Workspaces are the top-level grouping unit inside a SquaredUp tenant. Each workspace typically represents a team, product, environment, or business area, and groups its own dashboards, KPIs, and scope. Most read-side discovery (just listing what exists) is covered by the `explore-org` skill - this skill is for the write-side operations and the deeper config inspection of individual workspaces.1112## Tool map1314| Tool | What it does |15| ------------------ | -------------------------------------------------------------------------------------------------------- |16| `workspace_list` | List all workspaces in the tenant - id, displayName, type. Returns the workspaces visible to the caller. |17| `workspace_get` | Full single-workspace read - name, description, type, links. Returns null if not found / no access. |18| `workspace_create` | Create a new workspace. Body must include `displayName`; other fields optional. |19| `workspace_update` | Update an existing workspace. Full overwrite - read with `workspace_get` first. |2021## Standard workflow: create a workspace2223```js24workspace_create({25 body: {26 displayName: 'QA Environment',27 description: 'Quality assurance team and tests',28 },29});30// → { id: "space-..." }31```3233The new workspace's id is returned in the response. Optional fields like `description`, `type`, and `links` can be passed alongside `displayName`. The schema is open (`passthrough`) so the API accepts any additional fields the user provides.3435## Standard workflow: update a workspace (rename, description, etc.)3637`workspace_update` is a **full overwrite**, not a patch. Always:38391. `workspace_get(workspaceId)` - read the current body.402. Mutate the field the user asked for.413. `workspace_update({ workspaceId, body: <mutated body> })`.4243```js44const current = await workspace_get({ workspaceId: 'space-abc123' });45const updated = { ...current, displayName: 'QA Environment (renamed)' };46await workspace_update({ workspaceId: 'space-abc123', body: updated });47```4849## Standard workflow: inspect a workspace's full config5051`workspace_get(workspaceId)` returns the full config - description, type (the user-facing workspace type, e.g. `team`, `application`, `environment`), `links`, and `alertingRules`. Use this when the user asks _"what's in the X workspace's settings"_ rather than _"what's inside the X workspace"_ (which would be `dashboard_list` filtered by `workspaceId` - see `dashboards`).5253## Common mistakes5455- Calling `workspace_update` with a partial body - it's a full overwrite. `workspace_get` first, mutate, then update. Sending only the changed field will wipe everything else.56- Confusing "the workspace exists" (returned by `workspace_list`) with "I can read its config" (`workspace_get` may return `null` for access-controlled workspaces).57- Reaching for `workspace_get` when the user actually wants the _contents_ of the workspace - that's `dashboard_list` filtered by `workspaceId`.58- Creating a duplicate workspace by skipping `workspace_list` first - if uniqueness matters, confirm no workspace with the same `displayName` exists before `workspace_create`.5960## When to skip this skill6162- The user wants to list workspaces alongside other tenant resources (data sources, dashboards) → `explore-org`.63- The user wants the dashboards / tiles / KPIs _inside_ a workspace → `dashboards` / `kpis`.64- The user wants to duplicate an existing workspace as a template for a new one → `clone-workspace`.65- The user wants to manage who can access a workspace → `permissions`.66- The user is performing graph traversal that starts from a workspace node → `query-graph` (workspaces are `type: 'space'` graph vertices).
squaredup