workspace_update
Edit the active workspace (or one named by workspace_id): its name, description, logo_url, and/or settings. Requires ADMIN role in that workspace. settings is MERGED, not replaced — send only the keys you want to change (e.g. {"translation_glossary": "..."} or {"translation_tts_provider": "cartes...
This record as markdown: /tools/io-github-saloprj-dialogbrain/workspace-update.md
What workspace_update does on Dialogbrain
AI agents use workspace_update to create or update resources in Dialogbrain, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Dialogbrain environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | — | New workspace name. Omit to leave unchanged. |
logo_url | string | — | New workspace logo URL. Omit to leave unchanged. |
settings | object | — | Partial settings object, MERGED into the existing workspace.settings JSONB (PATCH semantics). Only the keys you send change. Common keys: translation_glossary, |
description | string | — | New workspace description. Omit to leave unchanged. |
workspace_id | integer | — | Numeric workspace id to update. Omit to target the currently-routed workspace (workspace.current). |
Parameters from the server's own tool schema.
Why workspace_update is rated Medium
workspace_update modifies workspace configuration and metadata in a reversible manner. It does not delete data (Destructive), execute arbitrary code (Execute), or move money (Financial). It requires ADMIN role, which shows it's a sensitive administrative function, raising severity to high due to the blast radius of misconfiguring workspace settings across a unified communications platform.
From the tool's definition Tool description states: "Edit the active workspace (or one named by `workspace_id`): its name, description, logo_url, and/or `settings`." The verb "Edit" combined with modifiable fields (name, description, logo_url, settings) indicates creation or…
Risk signalsAdmin/system-level operation
Attacks that exploit this kind of access
The rule that runs workspace_update safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Dialogbrain, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For workspace_update, this is the rule to start with:
workspace_update stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Dialogbrain, apply this rule, and every workspace_update call is checked against it from then on.
Questions about workspace_update
Edit the active workspace (or one named by workspace_id): its name, description, logo_url, and/or settings. Requires ADMIN role in that workspace. settings is MERGED, not replaced — send only the keys you want to change (e.g. {"translation_glossary": "..."} or {"translation_tts_provider": "cartesia"}); other keys are left intact. Omit workspace_id to target the workspace this MCP key is currently routed to (see workspace.current). It is categorised as a Write tool in the Dialogbrain MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
workspace_update accepts 5 parameters: name, logo_url, settings, description, workspace_id. The full parameter table on this page comes from the server's own tool schema.
Register the Dialogbrain MCP server in PolicyLayer and add a rule for workspace_update: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Dialogbrain. Nothing to install.
workspace_update is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the workspace_update rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for workspace_update. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
workspace_update is provided by the Dialogbrain MCP server (https://api.dialogbrain.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Dialogbrain, and thousands of servers like it.
This server
Across the catalogue