ReferenceFind the facts

Asset Picker parameters reference

This page specifies the host URLs, configuration parameters, and API routing for the CMP Asset Picker.

The Asset Picker accepts the same configuration whether you embed it as an iframe or as a web component. Supply configuration as URL query parameters on the iframe (camelCase), or as element attributes on the web component (kebab-case).

For how to apply this configuration, see Embed the Asset Picker.

Environments

Environment Host URL

Development

https://app.storyteq.io/asset-picker/

Staging

https://app.storyteq.work/asset-picker/

Production

https://app.storyteq.com/asset-picker/

The web component script for each environment is the host URL followed by web-component/asset-picker.umd.js. For example, in production: https://app.storyteq.com/asset-picker/web-component/asset-picker.umd.js.

Required parameters

The following parameters are required for an iframe.

Parameter URL parameter Web component attribute Description

Domain

domain

domain

The tenant domain whose assets the Asset Picker displays.

API key

apiKey

api-key

The API key used to access the lens.

Domain ID

domainId

domain-id

The identifier of the domain.

Lens ID

lensId

lens-id

The identifier of the lens whose assets the Asset Picker displays.

API integration and routing

The API integration setting determines which CMP API the Asset Picker calls.

apiIntegration (api-integration)

Selects the external Luma v2 endpoints for a given environment. Accepted values: external-prod, external-proxy, external-dev, external-qa, external-uat.

apiHostname (api-hostname)

Specifies the API host the Asset Picker calls.

The Asset Picker routes API requests as follows:

  • When apiIntegration is not set, the Asset Picker calls the internal Luma endpoints at the host it is loaded from:

    ${hostname}/api/${domain}/com.intrepia.luma.${endpoint}

  • When apiIntegration is set to external-site, the Asset Picker calls the Luma v2 endpoint for that environment:

    https://enterprise.api-${env}.storyteq.com

Optional parameters

The following optional parameters are accepted as URL parameters and web component attributes. Each takes a boolean value.

Parameter URL parameter Web component attribute

Allow multiple selection

allowMultiple

allow-multiple

Allow original asset

allowOriginalAsset

allow-original-asset

Allow events

allowEvents

allow-events

Allow external

allowExternal

allow-external

Allow public URL

allowPublicUrl

allow-public-url

Allow persistent

allowPersistent

allow-persistent

Allow fallback

allowFallback

allow-fallback

allowMultiple allows the user to select more than one asset.

Related pages