Switch workspace

Tool: switch_workspace. Requires Viewer or higher in the applicable workspace and a connected OAuth session. Select a group returned by list_workspaces. This changes the account-wide selection used by the UI and all MCP clients. Repeating the same selection is safe; invalid or inaccessible IDs fail without switching. Call list_agents after switching. Avoid parallel work across different workspaces under one account. Membership and roles are checked again for resource operations.

Arguments

Name	Type	Required	Defaults and limits
`group_id`	integer	Yes	exclusiveMinimum: `0`

Example arguments

Replace sample resource IDs with IDs returned in your selected workspace.

{
  "group_id": 32
}

Result and errors

The schema below describes MCP structuredContent, including the result wrapper where present. Your client may also display a text representation. Read success flags and structured errors before continuing; transport success alone does not prove the operation succeeded. Authentication, missing membership, and insufficient role can fail before a tool result is produced. See troubleshooting. Effect: Changes state. Retry: Declared idempotent. Discovery annotations describe behavior; they do not grant permission or replace confirmation for consequential actions.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "group_id": {
      "exclusiveMinimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "group_id"
  ],
  "type": "object"
}

Result schema

{
  "properties": {
    "group_id": {
      "type": "integer"
    },
    "group_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "public_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "role": {
      "type": "string"
    },
    "selection_scope": {
      "const": "account",
      "default": "account",
      "type": "string"
    },
    "tenant_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "tenant_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "tenant_id",
    "public_id",
    "tenant_name",
    "group_id",
    "group_name",
    "role"
  ],
  "type": "object"
}

Get started

Use MCP

Workspaces

Agents

Calls and outcomes

Phone numbers

Resources

Authoring guidance

Documentation

Arguments

Example arguments

Result and errors

​Arguments

​Example arguments

​Result and errors

Arguments

Example arguments

Result and errors