# Asset Embeddable Links

Embeddable Links provide a way to get a public (although unguessable) link to an optionally transformed [`AssetFile`](#operation/getAssetFiles) of an [`Asset`](#tag/Assets).


## Update an asset embeddable link

 - [PATCH /embeddable-links/{id}](https://api-docs.dash.app/dash/openapi/asset-embeddable-links/embeddablelink.md): Update an AssetEmbeddableLink resource's status.

Currently only a patch to status: REVOKED is supported.
This will update the AssetEmbeddableLink resource's status to REVOKED and fileStatus to DELETED.

## Create asset embeddable links

 - [POST /embeddable-link-batch-jobs](https://api-docs.dash.app/dash/openapi/asset-embeddable-links/postassetembeddablelinkbatchjob.md): An AssetEmbeddableLinkBatchJob should be created when you want to create embeddable links for multiple AssetFile resources.

There is a limit of 500 batch request items for this endpoint.
If more than 500 items are requested, the endpoint will error with a bad request(400) response.

The transformationDescription can be one of two types, CUSTOM or PRESET.

This definition and usage matches the transformationDescription used in AssetDownloadBatchJob.

A CUSTOM transformationDescription is a list of candidateTransformations which are evaluated in turn against each AssetFile specified in the request.
If the AssetFile  meets the candidateTransformation.criteria then the candidateTransformation.transformation is applied. Otherwise, the next candidate is considered.
The candidateTransformation.transformation is a series of operations to apply to the  AssetFile in order (e.g. resize to 200 by 100  and then covert to JPG). An empty list of operations indicates the file should be left untransformed.

A PRESET transformationDescription is similar to a CUSTOM transformation except the transformationDescription has been predefined.
These presets are currently only configurable via the Dash frontend, but can be found via a PresetTransformationSearch.

## Get the status of creating asset embeddable links

 - [GET /embeddable-link-batch-jobs/{id}](https://api-docs.dash.app/dash/openapi/asset-embeddable-links/getassetembeddablelinkbatchjob.md): Get the status and eventual result of an AssetEmbeddableLinkBatchJob

## Discard creating asset embeddable links

 - [DELETE /embeddable-link-batch-jobs/{id}](https://api-docs.dash.app/dash/openapi/asset-embeddable-links/deleteassetembeddablelinkbatchjob.md): Stops an AssetEmbeddableLinkBatchJob and deletes it

## Search for asset embeddable links

 - [POST /embeddable-link-searches](https://api-docs.dash.app/dash/openapi/asset-embeddable-links/postembeddablelinksearches.md): Create a new AssetEmbeddableLinkSearch.
The criterion and sort currently support search by ASSET_ID field only.