Skip to main content

ExternalApiEndpointsImportRequest

Parses the spec and upserts endpoints on the connector, matched to existing rows by operationId (fallback method+path) so endpoint primary keys — and any authored MCP tool definitions referencing them — survive re-import. Endpoints present in the connector but absent from this spec are soft-deleted, cascading to their tool definitions.

specobjectrequired

The raw OpenAPI document (2.0, 3.0, or 3.1) to parse, as JSON.

baseUrlstring<uri>

Overrides the connector's baseUrl when provided.

generateDefaultsboolean

When true, also seeds a default mcp_tool_definitions row (created disabled) for every endpoint newly added by this import.

ExternalApiEndpointsImportRequest
{
  "spec": {},
  "baseUrl": "string",
  "generateDefaults": true
}