Skip to main content
POST
/
api
/
datachecks
/
scheduler
/
v1
/
trigger
TriggerDatachecks
curl --request POST \
  --url https://developer.synq.io/api/datachecks/scheduler/v1/trigger \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityIds": [
    {
      "airflowDag": {
        "integrationId": "<string>",
        "dagId": "<string>"
      }
    }
  ]
}
'
{
  "results": [
    {
      "sqlTestResult": {
        "sqlTestId": "<string>",
        "entityIds": [
          {
            "airflowDag": {
              "integrationId": "<string>",
              "dagId": "<string>"
            }
          }
        ],
        "rowsCount": 123,
        "executionId": "<string>",
        "executedAt": "2023-11-07T05:31:56Z",
        "errorMessage": "<string>",
        "resultData": "<string>"
      },
      "status": "DATACHECK_STATUS_UNSPECIFIED",
      "monitorResult": {
        "monitorId": "<string>",
        "entityId": {
          "airflowDag": {
            "integrationId": "<string>",
            "dagId": "<string>"
          }
        },
        "executionId": "<string>",
        "executedAt": "2023-11-07T05:31:56Z",
        "errorMessage": "<string>",
        "metricValue": 123,
        "expectedValue": 123,
        "upperBound": 123,
        "lowerBound": 123
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
entityIds
(airflow_dag · object | airflow_task · object | bigquery_table · object | clickhouse_table · object | custom · object | databricks_table · object | dataproduct · object | dbt_cloud_node · object | dbt_core_node · object | monitor · object | mysql_table · object | postgres_table · object | redshift_table · object | snowflake_table · object | sql_mesh_audit · object | sql_mesh_model · object | synq_path · object | trino_table · object)[]

List of entity identifiers to trigger datachecks for.

Minimum array length: 1

Identifier is a unique reference to an entity in SYNQ system. Entity identifiers are designed to closely mimic identifiers used by data platforms and tools. To construct an identifier, you need to know the kind of the entity and the ids that you would normally use to identify it in the data platform or tool. For example, to identify a table in BigQuery, you would need to know the project, dataset, and table names.

Response

200 - application/json

Success

​
results
DatacheckResult · object[]

Results from all datacheck executions.

Result from a single datacheck execution.