Acceldata
ADOC

Manage Policies by Name

These APIs let you manage an existing Data Quality policy using its name instead of the numeric ID.

This is useful in automated workflows or CI/CD pipelines where the policy name is stable and easier to reference than its internal ID.

Endpoint(s)

GET    /catalog-server/api/rules/data-quality/byName/:name           (get)
PUT    /catalog-server/api/rules/data-quality/byName/:name           (update)
DELETE /catalog-server/api/rules/data-quality/byName/:name           (delete/archive)
POST   /catalog-server/api/rules/data-quality/byName/:name/unarchive (unarchive)
PUT    /catalog-server/api/rules/data-quality/byName/:name/schedule  (toggle schedule)
GET    /catalog-server/api/rules/data-quality/byName/:name/items     (list items)
GET    /catalog-server/api/rules/data-quality/byName/:name/executions (list executions)
POST   /catalog-server/api/rules/data-quality/byName/:name/executions (execute policy)

Path Parameters

Name

Type

Required

Description

name

string

Yes

Unique name of the Data Quality policy.

Sample Request

Manage a Data Quality policy by name

curl -X PUT "https://{HOST}/catalog-server/api/rules/data-quality/byName/Customer_DQ_Policy" \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer $TOKEN" \
 -H "accessKey: $ACCESS_KEY" \
 -H "secretKey: $SECRET_KEY" \
 -d '{
    "description": "Updated DQ policy to check for null values and pattern mismatches on critical columns.",
    "status": "ACTIVE",
    "scheduled": true,
    "schedule": "0 2 * * *",
    "rules": [
      {
        "columnName": "email",
        "measurementType": "NULL_VALUES",
        "threshold": 0
      },
      {
        "columnName": "email",
        "measurementType": "PATTERN_MISMATCH",
        "pattern": "^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$"
      },
      {
        "columnName": "country_code",
        "measurementType": "REFERENCE_CHECK",
        "referenceDataset": "valid_country_codes"
      }
    ],
    "tags": ["customer", "critical", "data-quality"]
  }'

What this does:

  • Updates an existing Data Quality policy named Customer_DQ_Policy.

  • Schedules it to run daily at 2 AM (0 2 * * *).

  • Adds multiple DQ rules including:

    • Null check

    • Pattern validation

    • Reference check

  • Attaches descriptive tags.