Content Hub actions

The Content Hub extension provides actions for creating and managing digital assets in Amplience Content Hub within Workforce flows. Use these actions to upload images, update metadata, manage workflow status, and organise assets as part of your automated content processes.

Tip

These action descriptions cover the most commonly used inputs and outputs. When designing flows, you may also notice additional input and output variables.

Upload Image Asset

Creates a new asset in Content Hub from a source image.

Inputs

Input	Type	Required	Description
image	object	Yes	The source image to upload. Must include type (must be "Image") and url. Optionally includes id and tags
filename	string	Yes	The filename to use when storing the asset (e.g. product-1.jpg)
name	string	Yes	A programmatic identifier for the asset, without a file extension (e.g. product-1)
mode	string	No	What to do if an asset with the same name already exists. Accepted values: rename_unique (default), overwrite
inheritTags	boolean	No	When enabled, tags from the input image are copied to the new asset. Default: true
assetRepositoryId	string	No	The Asset Repository where the new asset will be stored
folderId	string	No	The folder within the repository where the asset will be saved

Outputs

Output	Type	Description
asset.id	string	The ID of the newly created asset

Featured in these example flows

• Image tagging and Content Hub upload example

Publish Asset

Publishes an asset in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to publish

Outputs

Output	Type	Description
job.id	string	The unique identifier of the publishing job that was created

Rename Asset

Updates the file name or API name of an existing asset in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to rename
filename	string	No	The new filename to use when storing or downloading the asset (e.g. product-1.jpg)
name	string	No	The new programmatic identifier for the asset, without a file extension (e.g. product-1)
mode	string	No	What to do if an asset with the same name already exists. Accepted values: rename_unique (default), overwrite

Outputs

No output properties are returned by this action.

Move Asset

Moves an existing asset to a different repository or folder in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to move
assetRepositoryId	string	No	The Asset Repository to move the asset to
folderId	string	No	The folder within the target repository to move the asset to
mode	string	No	What to do if an asset with the same name already exists in the target location. Accepted values: rename_unique (default), overwrite

Outputs

No output properties are returned by this action.

Transition Asset Status

Transitions an asset to a new workflow status in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to transition
newStatus	string	No	The new workflow status to assign. Accepted values: dam:draft, dam:archived, dam:review, dam:rejected, dam:approved

Outputs

No output properties are returned by this action.

Update Asset Tags

Adds or removes tags on an existing asset in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to update
add	array of strings	No	Tags to add to the asset
remove	array of strings	No	Tags to remove from the asset

Outputs

No output properties are returned by this action.

Replace Image Asset

Replaces the image file associated with an existing asset in Content Hub, while keeping the asset's ID and metadata.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to replace
image	object	No	The new source image to upload. Must include type (must be "Image") and url. Optionally includes id and tags
inheritTags	boolean	No	When enabled, tags from the input image are copied to the asset. Default: true

Outputs

No output properties are returned by this action.

Update Asset Alt Text

Updates the default and locale-specific alt text descriptions on an asset in Content Hub.

Inputs

Input	Type	Required	Description
assetId	string	Yes	The ID of the asset to update
defaultAltText	string	No	A default phrase that explains the image content (e.g. White running shoes with blue soles on a wooden floor)
altTextVariants	object	No	Locale-specific alt text descriptions. Must include a _meta object with schema set to http://bigcontent.io/cms/schema/v1/core#/definitions/localized-value, and a values array of objects each with locale (string, required) and value (string, required)

Outputs

No output properties are returned by this action.

Featured in these example flows

• Automatic alt text example

Related pages

Adding actions to flows

Inputs, outputs and ports

Input field variables

Developing extensions