Trigger the 'Refine MCP descriptions' AI feature for a connector

POST 
/external-apis/:id/refine-descriptions

Dispatches an iterative audit-and-rewrite loop (orchestrator + auditor + critic agents) that rewrites every enabled MCP tool description on this connector, verified by an independent critic before it ships. Requires at least the client role in the owning organization (or the connector is public) — note this checks the view ability, not manage. Returns 409 if a non-terminal run for this feature and connector is already in flight. Estimated cost $1-5, estimated duration 60-900s.

Request

Responses

200

The dispatched run, in pending status

400

Invalid ID format (not a positive integer)

401

Authentication required

404

Resource not found

409

A run for refine_mcp_descriptions on this connector is already in flight

422

Validation failed