v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141891,2951.1 MB

Creates a data asset filter.

Asset filters provide a sophisticated way to create controlled views of data assets by selecting specific columns or applying row-level filters. This capability is crucial for organizations that need to share data while maintaining security and privacy controls. For example, your database might be filtered to show only non-PII fields to certain users, or sales data might be filtered by region for different regional teams. Asset filters enable fine-grained access control while maintaining a single source of truth.

Prerequisites:

  • A valid domain (--domain-identifier) must exist.

  • A data asset (--asset-identifier) must already be created under that domain.

  • The asset must have the referenced columns available in its schema for column-based filtering.

  • You cannot specify both (columnConfiguration, rowConfiguration)at the same time.

post/v2/domains/{domainIdentifier}/assets/{assetIdentifier}/filters

Path parameters

domainIdentifierstring required

The ID of the domain in which you want to create an asset filter.

assetIdentifierstring required

The ID of the data asset.

Request body

namestring password required

The name of the asset filter.

descriptionstring password

The description of the asset filter.

clientTokenstring

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

Response

Success

idstring required

The ID of the asset filter.

domainIdstring required

The ID of the domain where the asset filter is created.

assetIdstring required

The ID of the asset.

namestring password required

The name of the asset filter.

descriptionstring password

The description of the asset filter.

status'VALID' | 'INVALID'

The status of the asset filter.

createdAtstring date-time

The timestamp at which the asset filter was created.

errorMessagestring

The error message that is displayed if the asset filter is not created successfully.

effectiveColumnNamesString[]

The column names in the asset filter.

effectiveRowFilterstring

The row filter in the asset filter.