Skip to main content
PUT
PUT /v1/dataProducts/{fqn}/assets/add

Ports & Assets

Manage the input ports, output ports, and associated assets of a data product. These endpoints allow you to add or remove data assets from a data product without replacing the entire entity. An asset can be either an input port or an output port of a data product, not both. If every asset in the request is rejected, the request returns 400. If only some are rejected, it returns 200 and lists each rejected asset with its reason in failedRequest. Ports must reference a data asset, so column-level entities such as tableColumn are rejected.

Add Assets

Use PUT /v1/dataProducts/{fqn}/assets/add to add assets to a data product.
string
required
Fully qualified name of the data product, such as CustomerInsights.
array
required
Array of entity references to add as assets.

Remove Assets

Use PUT /v1/dataProducts/{fqn}/assets/remove to remove assets from a data product.
string
required
Fully qualified name of the data product, such as CustomerInsights.
array
required
Array of entity references to remove.
PUT /v1/dataProducts/{fqn}/assets/add

Returns

Returns a bulk operation result. status is success when no asset was rejected, partialSuccess when some were rejected, and failure when every asset was rejected. The numberOfRowsProcessed, numberOfRowsPassed, and numberOfRowsFailed fields hold the counts. successRequest lists each accepted asset reference, and failedRequest lists each rejected asset reference with the reason in message. A dry run (dryRun: true) of the add or remove assets endpoints reports the result without changing any asset. The input and output port endpoints don’t support dry runs.

Error Handling