Start DDEX connection health check

Check credentials, endpoint configuration, licensed schema assets, live transport gates, and connection readiness without exposing secrets. Staging sandbox checks are isolated and report whether simulation or an external probe was used.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

reference*string

Formatuuid

Header Parameters

Idempotency-Key*string

Unique request key. Reuse with the same body replays the result; reuse with a different body returns a conflict.

Length8 <= length <= 255

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/ddex/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08/health-check" \  -H "Idempotency-Key: stringst"

{  "data": {    "reference": "3bc1f628-60af-4db2-b984-321c1525df20",    "name": "Partner sandbox",    "partner_name": "Partner DSP",    "commercial_route": "direct_partner",    "direction": "outbound",    "environment": "sandbox",    "status": "testing",    "review_status": "approved",    "conformance_status": "testing",    "transport_enabled": false,    "local_dpid": "PA-DPIDA-2026072901-N",    "remote_dpid": "PA-DPIDA-2026072902-N",    "ern_version": "4.3.2",    "release_profile": "Audio",    "avs_version": "011",    "choreography": "web_service_1_8",    "hosting_mode": "spacemedia_managed",    "auth_type": "bearer",    "capabilities": [      "insert",      "update",      "global_takedown"    ],    "health": {      "status": "healthy",      "checked_at": "2026-07-30T15:20:00Z"    },    "version": 1,    "credentials_configured": true,    "credentials_rotated_at": "2026-07-30T15:10:00Z",    "issues": [],    "simulated": true,    "external_probe_performed": false  }}

Authorization

Path Parameters

Header Parameters

Response Body

202application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`