Skip to main content
POST
Refresh an MCP tool catalog
Requires Editor, Admin, or Owner; credentialed configurations additionally require Admin or Owner. This contacts the configured MCP server. Inspect the returned success/error fields even when HTTP status is 200. On discovery failure, the service retains the cached catalog. This manages an agent tool connection; it does not change the OAuth flow for Agent Builder’s own MCP endpoint. For Calendly-managed tools, refresh uses the workspace Calendly connection and requires Admin or Owner. Inspect error and reconnect through the integration if access is unavailable.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Path Parameters

tool_uuid
string
required

Response

Successful Response

tool_uuid
string
required
discovered_tools
any[]
error
string | null