Refresh MCP tools for a connector

Discover the remote MCP server tools and reconcile the cached connector actions. The response reports the resulting refresh status and retains the previous successful tool set if discovery fails. Remote discovery and provisioning failures return HTTP 200 with an ERROR refresh status.

post

Authorizations

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

connector_idstringRequired

The unique identifier of the MCP connector

Header parameters

X-API-Versionstring · enumOptional

Meta Business Agent API version

Possible values:

Responses

200

The connector with updated MCP tool sync metadata

application/json

A single connector

auth_typestring · enumRequired

Authentication type for this connector

Possible values:

base_urlstringRequired

Base URL of the external API

connector_protocolstring · enumOptional

Protocol used by this connector. Defaults to HTTP when omitted.

Possible values:

descriptionstringRequired

Description of the connector

idstringRequired

The unique identifier for this connector

Example: 1234567890

namestringRequired

Display name of the connector

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

429

Too many requests

application/json

500

Server error

application/json

post/agent_connectors/{connector_id}/refreshMCPTools

POST /agent_connectors/{connector_id}/refreshMCPTools HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{
  "auth_config": {
    "api_key": {
      "body_params": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ],
      "headers": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ],
      "query_params": [
        {
          "field_name": "text",
          "prefix": "text",
          "value": "text"
        }
      ]
    },
    "oauth2_client_credentials": {
      "client_id": "text",
      "client_secret": "text",
      "scopes_to_request": [
        "text"
      ],
      "token_request_content_type": "text",
      "token_url": "text"
    }
  },
  "auth_type": "OAUTH2",
  "base_url": "text",
  "connection_status": {
    "error_message": "text",
    "status": "PENDING_OAUTH"
  },
  "connector_protocol": "HTTP",
  "description": "text",
  "id": "1234567890",
  "mcp_tool_sync": {
    "fingerprint": "text",
    "last_attempted_at": 1,
    "last_successful_at": 1,
    "status": "ERROR",
    "tool_count": 1
  },
  "mtls_config": {
    "ca_certificate": "text",
    "client_certificate": "text",
    "expires_at": 1,
    "fingerprint": "text",
    "has_certificate": true,
    "subject": "text"
  },
  "name": "text",
  "user_auth_injection_config": {
    "field_name": "text",
    "location": "body",
    "prefix": "text"
  }
}