---
title: "Create a Digital Asset & Metadata"
method: POST
path: "/{organization_id}/digital_assets"
---

# 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_id` string, required

## Request body

- object
  - `salsify:source_url` string, required: An HTTP(S) URL of a public image on the Internet.
  - `salsify:id` string: The identifier to use for the asset. A randomly generated ID is assigned if not specified.
  - `additional_metadata` string: Additional optional metadata ([system](https://salsify.readme.io/v1.0/reference#section-digital-asset-metadata-attributes) 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_source` boolean: 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`

200

- object
  - `salsify:id` string
  - `salsify:source_url` string
  - `salsify:name` string
  - `salsify:created_at` string
  - `salsify:updated_at` string
  - `salsify:status` string
  - `salsify:asset_resource_type` string
  - `salsify:system_id` string
  - `Asset Photographer` string

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param.md) - [All operations](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param/llms.txt) - [OpenAPI document](https://skmtc.dev/salsify/apis/no-api-explorer-for-destructive-calls-not-well-defined-param/revisions/e45c99004f46?raw)