Skip to main content
POST
Run the live test of a connection. For a key provider, this checks the credentials. For a custom MCP server, it checks the server. For a custom webhook, it sends a signed ping event to the URL of the first action. The result is stored on the connection. A failed test is not an HTTP error. It comes back as ok: false with a fixed message. A webhook counts as connected when your endpoint answers any 2xx status. The body is not read. See The ping test.

Request

Headers

string
required
Bearer token with your API key (scope agents)

Path

string
required
The connection id (UUID)

Response

200 OK
or, when the test failed:

Errors

Example