Create a Digital Asset & Metadata

post/{organization_id}/digital_assets

Request

  • Base URL
    https://app.salsify.com/api/v1/orgs
  • URL
    https://app.salsify.com/api/v1/orgs/{organization_id}/digital_assets
  • Auth
    API key in header Authorization

Path parameters

organization_idstring required

The Salsify organization's unique identifier. Visit your Salsify organization and pull from the URL path, immediately following /orgs/

Request body

salsify:source_urlstring required

An HTTP(S) URL of a public image on the Internet.

salsify:idstring

The identifier to use for the asset. A randomly generated ID is assigned if not specified.

additional_metadatastring

Additional optional metadata (system or custom) can be added in value pairs. {metadata_id} : {metadata_value} where metadata_id is a Salsify property, and metadata_value is the corresponding property value. If metadata_id does not exist in org, property will be created.

salsify:transient_sourceboolean

When set to true, the source_url is not persisted on the asset in Salsify, and the asset is treated as if it were uploaded as a file in the UI

Response

200

salsify:idstring
salsify:source_urlstring
salsify:namestring
salsify:created_atstring
salsify:updated_atstring
salsify:statusstring
salsify:asset_resource_typestring
salsify:system_idstring
Asset Photographerstring

Example response

{
  "salsify:id": "dandelion_new_10002",
  "salsify:source_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/4f/DandelionFlower.jpg/440px-DandelionFlower.jpg",
  "salsify:name": "dandelion_flower.png",
  "salsify:created_at": "2017-11-28T19:18:17.913Z",
  "salsify:updated_at": "2017-11-28T19:18:17.913Z",
  "salsify:status": "in_progress",
  "salsify:asset_resource_type": "raw",
  "salsify:system_id": "s-999-999-999-999",
  "Asset Photographer": "LB Jeffreys"
}

Changes

No recorded changes to this operation across all 1 revision of this API.