Create destination connection check

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

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

POST

api

destinations

{destination_id}

connection-check

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

{
  "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

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

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

Get destination connection check Job endpoints

​Path parameters

​Response

Path parameters

Response