Skip to main content
PATCH
Update a workspace

Authorizations

Authorization
string
header
required

Enter your API key with the Bearer prefix — e.g. Bearer sk_live_xxx (production) or Bearer sk_test_xxx (sandbox)

Path Parameters

id
string<uuid>
required

Workspace UUID.

Body

application/json

Partial update — send only the fields to change. environment is immutable after creation.

name
string

New workspace display name.

Required string length: 1 - 100
Example:

"Renamed Bot"

integrations
enum<string>[]

Toolkit slugs to expose. Pass [] to reset the workspace to expose all integrations.

Available options:
github,
gmail,
hubspot,
jira,
monday-crm,
notion,
pipedrive,
quickbooks-online,
salesforce,
slack,
xero,
zoho-books,
zoho-crm
Example:
openRouterApiKey
string
write-only

Set or replace the workspace's per-workspace OpenRouter API key (bring-your-own LLM key). Input-only: validated, encrypted at rest, and NEVER returned in any response. Use DELETE /mcp/workspaces/{id}/llm-key to remove it.

Minimum string length: 8
Example:

"sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxx"

model
string

OpenRouter model id in vendor/model format.

Example:

"anthropic/claude-sonnet-4-6"

statelessMode
boolean
default:false

Toggle stateless chat for this workspace. When true, POST /mcp/{workspaceId}/chat persists nothing and the caller must supply prior turns via history. Default false.

Example:

false

Response

Workspace updated.

data
object
required