Update DQ tags for a table

Update (delete) DQ tags for columns in a table. This is a delete-only operation: for each column in the request, tags in the DB that are NOT in the request will be deleted. Columns not in the request are unchanged. Request tags not in DB are ignored.

PUT /api/data-readiness/data-assets/tables/dq-tags

Update DQ tags for a table

cURL

curl --request PUT \
  --url https://api.example.com/api/data-readiness/data-assets/tables/dq-tags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "columns": [
    {
      "name": "<string>",
      "data_quality": [
        {}
      ]
    }
  ]
}
'

200

{
  "success": true,
  "table_fqn": "<string>",
  "columns_processed": 0,
  "tags_deleted": 0,
  "tags_preserved": 0,
  "tags_not_found": 0,
  "errors": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

JWT Bearer token authentication. Include the token in the Authorization header as: Authorization: Bearer <token>. The JWT must contain valid client_id, and project_id claims for tenant isolation and SDK routing.

Query Parameters

fqn · string · required

Fully qualified name of the table (e.g., service.database.schema.table)

Minimum string length: 1

Body

application/json

Request model for updating (deleting) DQ tags on a table's columns.

This is a full-replacement delete-only operation:

• For each column in the request: delete DB tags whose IDs are NOT in data_quality list
• Columns NOT in request: unchanged (their tags are preserved)
• Tags in request that don't exist in DB: ignored (no adding)

columns · ColumnDqTagUpdate · object[] · required

Columns with their desired DQ tag state.

Minimum array length: 1

Show child attributes

Response

200

application/json

Successful Response

Result of updating DQ tags for a table.

The success field indicates whether the operation completed without errors:

• True: All requested deletions were processed successfully
• False: One or more errors occurred (e.g., invalid UUID format)

Note: Even when success=False, some tags may have been successfully deleted. Check tags_deleted for the actual count of deleted tags. The errors field contains details about what failed.

success · boolean · required

Whether the update completed successfully (no errors)

table_fqn · string · required

Fully qualified table name

columns_processed · integer · default: 0

Number of columns processed from request

tags_deleted · integer · default: 0

Number of DQ tags deleted

tags_preserved · integer · default: 0

Number of DQ tags preserved (not deleted)

tags_not_found · integer · default: 0

Number of tag IDs in request that didn't exist in DB (ignored)

errors · string[] | null

Error messages if any