Skip to main content

PIMS Digital Asset Management API

POST 
/pim/manage/assets

The assets API in PIMS offers a versatile set of tools for managing digital resources. It facilitates the generation of unique asset codes, retrieval and update of asset metadata, movement of assets between buckets, and fetching asset streams in various sizes.

To use this API, send a POST request with a JSON body.✔The description of JSON keys is provided in the Example Value and Schema sections. Set the action key in the JSON body to one of the following values:

  • generateAssetCode: Generate Unique Asset Code.Method for obtaining a unique asset code used for managing associated data and resource upload.

  • updateAssetData: Update Asset Metadata. Method for updating asset metadata based on its unique code.

  • getAssetData: Get Asset Metadata. Method for retrieving asset metadata based on its unique code.

  • getAssetDataList: Get List Asset Metadata. Method for retrieving metadata for a list of specified unique asset codes, along with 'invalid_codes': a list of asset codes not found in the repository

  • deleteAsset: Delete Asset. Removes the asset from the repository if it is not linked to any products. If the optional force_unlink parameter is true when deleting an asset, its link to all products in which it is used will be broken. Note: The data in the product associated with the asset will be deleted.

Asset Loading and Retrieval API

For LOAD or UPDATE an Asset: POST https://instancename.piminto.com/api/a/AssetCode/

Ensure the Asset file is included in the request body for a successful operation.

For RETRIEVING an Asset: GET https://instancename.piminto.com/api/a/AssetCode/ or GET https://instancename.piminto.com/api/a/AssetCode/file.extension

Request​

Responses​

success