Update which workspaces may use a connector

PUT/v1/mcp-integrations/{slug}/workspaces

Update which workspaces may use a connector.

For organization-level connectors: sets global_workspace_access and adds or updates per-workspace entries; workspaces not listed keep their setting. A workspace that loses access keeps its MCP servers on the connector, but they cannot be used.

Requires an organization admin key, or a workspace admin key for the owning workspace (an organization-level connector needs an organization admin). Returns 400 for a workspace-owned connector, or a workspace outside the organization. Returns 402 when the organization's plan does not include the MCP Gateway. Returns 404 when the connector does not exist in the organization.

Authorization

AuthorizationBearer va_
A platform API key (va_...), created under Settings > API keys. Scoped to an organization or one workspace, with an admin or member role. Used by the management API.

Path parameters

slugstringrequired
The connector's slug (mcpi-...).

Query parameters

organizationstringrequired
The organization's identifier (slug).

Request body application/json

the access to set

global_workspace_accessboolean
true lets every workspace use the connector, whatever the entries say. Absent: unchanged.
workspacesobject[]
Per-workspace settings to add or update. Each workspace must belong to the organization.
Child attributes
- workspace_idstring<uuid>required
  The workspace (UUID).
- enabledbooleanrequired
  true lets the workspace use the connector, false does not.

Responses

200application/json

global_workspace_accessboolean
Whether every workspace in the organization may use it.
owner_workspace_idstring<uuid>
The owning workspace (UUID). Absent for an organization-level connector.
workspacesobject[]
The per-workspace settings of an organization-level connector.
Child attributes
- workspace_idstring<uuid>required
  The workspace (UUID).
- enabledbooleanrequired
  true lets the workspace use the connector, false does not.

Request

curl -X PUT "https://api.vectoraxis.ai/v1/mcp-integrations/{slug}/workspaces?organization=string" \
  -H "Authorization: Bearer $VECTORAXIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "global_workspace_access": true,
  "workspaces": [
    {
      "workspace_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b8c9a01",
      "enabled": true
    }
  ]
}'

VectorAxis is built by GK Labs, a member of NVIDIA Inception.