Data Quality Rules

Create rules in batch

Create up to 100 rules in a single request.

Each item requires name, inputGroups, and implementation. Store each sub-entity under a temporary key that you choose, such as new_email.

Unlike Create rule, batch-created rules skip the draft stage and are created directly as published versions. Each rule must therefore be complete and meet the publish requirements.

Each item is processed independently: a failure on one item does not cancel the rest. An item that violates the schema, such as a missing required field, rejects the whole request with 400 instead. The response is 207 Multi-Status. It contains a meta summary (total, success, fail) and per-item results. On success, a result carries the URN of the created rule (rather than the full body, to keep the response small) and, in correlationIds, the key assigned to each sub-entity the item created. On failure, it carries the error instead.

By default, results are paired with the request items by position: the first result belongs to the first item you sent. You can also add your own id to each item; the response returns it in the matching result.

post/data-quality/v1/rules/batch/create

Request

Request body

Example request

{
  "data": [
    {
      "defaultDqThreshold": {
        "severity": "WARNING",
        "correlationId": "new_email"
      },
      "stewardship": {
        "groupUrn": "urn:ata:acme-corp:iam:group:123e4567-e89b-12d3-a456-426614174000"
      },
      "implementation": {
        "ruleType": "SINGLE_TABLE",
        "dqDimensionUrn": "urn:ata:acme-corp:data-quality:dq-dimension:123e4567-e89b-12d3-a456-426614174000",
        "fallback": {
          "resultUrn": "urn:ata:acme-corp:data-quality:dq-dimension-result:123e4567-e89b-12d3-a456-426614174000"
        }
      }
    }
  ]
}

Response

Multi-status batch outcome. Each item in results reports its own outcome: OK with the created rule's URN and its correlationIds mapping in data, or a non-OK status with error. Inspect meta for the success and failure totals.

Example response

{
  "meta": {
    "total": 2,
    "success": 2
  },
  "results": [
    {
      "status": "OK",
      "data": {
        "urn": "urn:ata:acme-corp:data-quality:rule:123e4567-e89b-12d3-a456-426614174000"
      }
    }
  ]
}

Changes

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