integrations

Test Agent Ping

BRIEF-001 §6 IN-2 — canary request against a candidate agent endpoint.

Posts one synthetic payload (shape: payload.payload_schema) to the URL the customer typed into the connect form. Returns request + verbatim response + typed result class. The customer reads the response inline to fix auth / shape mismatches BEFORE committing to a full benchmark run.

Auth-required: prosumers wire this against their own infrastructure, not the public internet from an anonymous caller. The SSRF gate is the same resolve_public_url + pinned_request_kwargs pattern used by /test-connection and arena._call_agent_endpoint so a malicious endpoint string can't reach 169.254.169.254 or 127.0.0.1.

post/api/v1/integrations/agent-test-ping

Request

  • Base URL: https://api.badgeia.com
  • URL: https://api.badgeia.com/api/v1/integrations/agent-test-ping
  • Auth: none declared

Request body

endpointstring required
payload_schema'badge_native' | 'openai_chat' | 'anthropic_messages'
auth_typestring
auth_tokenstring nullable
promptstring nullable

Response

Successful Response

successboolean required
status_codeinteger nullable required
latency_msinteger nullable required
result'success' | 'non_2xx' | 'bad_response_shape' | 'connection_refused' | 'timeout' | 'ssrf_blocked' | 'response_too_large' | 'endpoint_url_unsupported' required
payload_schemastring required
request_bodyobject required
response_body_previewstring nullable required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.