Create destination connection check

Test a destination connection by creating a connection check for the specified destination connector.

POST /api/v1/destinations/{destination_id}/connection-check

cURL

curl --request POST \
  --url "${UNSTRUCTURED_API_URL}/api/v1/destinations/d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c/connection-check" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

Response

{
  "id": "c1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "status": "SCHEDULED",
  "reason": null,
  "created_at": "2026-01-01T00:00:00Z",
  "reported_at": null
}

The Python SDK does not support testing destination connectors.

Path parameters

destination_id · string · required

The unique identifier of the destination connector.

Response

id · string · required

Unique identifier for the connection check.

status · string · required

Connection check status. One of: SCHEDULED, SUCCESS, FAILURE.

reason · string

Failure reason, if applicable.

created_at · string · required

ISO 8601 timestamp when the check was initiated.

reported_at · string

ISO 8601 timestamp when the check result was reported.

cURL

curl --request POST \
  --url "${UNSTRUCTURED_API_URL}/api/v1/destinations/d1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c/connection-check" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

Response

{
  "id": "c1a2b3c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
  "status": "SCHEDULED",
  "reason": null,
  "created_at": "2026-01-01T00:00:00Z",
  "reported_at": null
}