Skip to main content
POST
Verify agent connection

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

agent_uuid
string
required

The agent whose connection to verify

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Body

application/json

Body for verifying an existing agent by ID. The endpoint (agent_url, agent_headers) comes from the agent's stored config, so only the probe inputs are accepted here.

model
string | null

Model to verify. Omit for a basic connection check. Provide it for a model-specific check before benchmarking that model

Example:

"openai/gpt-4.1"

messages
object[] | null

Sample chat messages to send during verification. Omit to use the default probe

Example:

Response

Successful Response

success
boolean
required

True if the agent responded successfully to the verification probe

error
string | null

Reason the verification failed

sample_response
object | null

Sample output returned by the agent during verification