Execute a live test call against an endpoint

POST 
/external-apis/:connectorId/endpoints/:id/test

Issues a real HTTP request to the upstream API using the connector's configured auth, applying any pinnedParams. Does not create call logs or bill data tokens. A successful JSON 2xx response is cached as the endpoint's sampleResponse. Requires at least the client role in the owning organization; unlike the transparent proxy, test calls are never available cross-organization even for public connectors.

Request

Responses

200

The upstream response (status, headers, body), regardless of the upstream's own status code

400

Invalid ID format (not a positive integer)

401

Authentication required

403

The connector is currently paused

404

Resource not found

422

Validation failed

502

Could not connect to the upstream API, or failed to obtain an OAuth2 access token

503

The connector has been suspended

504

The upstream request timed out