# Create asset embeddable links

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.

Endpoint: POST /embeddable-link-batch-jobs
Version: 2.0.0
Security: bearerToken

## Request fields (application/json):

  - `items` (array, required)

  - `items.batchItemId` (string, required)
    An ID provided by the caller to uniquely identify this item in the batch request
This is will be used to match the relevant results in the batch result
    Example: "my-item-1"

  - `items.assetId` (string, required)
    The ID of the [Asset](#tag/Assets) to create an embeddable link for
    Example: "7af90a8b-7ccd-430f-a85d-e8614015bc47"

  - `items.assetFileId` (string,null)
    The ID of the [AssetFile](#operation/getAssetFiles) to create an embeddable link for. If null the current [AssetFile](#operation/getAssetFiles) is used.
    Example: "7af90a8b-7ccd-430f-a85d-e8614015bc47"

  - `items.presetParameters` (array)
    PresetParameters for this assetId

  - `transformationDescription` (any, required)

## Response 4XX fields (application/json):

  - `timestamp` (string)
    The datetime that the error occurred in ISO offset format
    Example: "2021-02-16T16:21:58.640+00:00"

  - `status` (integer)
    The HTTP status code of the error
    Example: 401

  - `error` (string)
    The title of the error
    Example: "Unauthorized"

  - `message` (string)
    A more detailed error message

  - `path` (string)
    The path that was called which led to the error
    Example: "/folder-settings"