Save as a new asset

post

https://{your-bynder-domain}/api/v4/media/save/{importId}

For metaproperties that use options (Select, Select2, Autocomplete), modifying an asset's metaproperty options should be done via option UUID's for the API to work optimally, sending name or label values will be deprecated in the future. Other metaproperties (Date, Text and Longtext), values can be submitted directly. Be aware that the endpoints described in Step 6 are an Either/Or choice. You should use either the Save as a new asset endpoint to save the uploaded file as a new asset, or the Update existing asset endpoint to update an existing asset with the uploaded file.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

importId

string

required

Import id of a finalised and processed upload to be saved.

Form Data

brandId

string

Brand id to save the asset to.

name

string

Name of the asset.

description

string

Extended asset description.

copyright

string

Copyright information of the asset.

tags

string

Comma-separated list of tags of the asset.

metaproperty

string

Dictionary with (metaproperty) options to set on the asset. Send fields as metaproperty.METAPROPERY_ID with a string of all its (metaproperty) options ids comma-separated.

categories

string

Comma-separated category ids of the asset.

audit

boolean

Flags if the asset should be sent to the waiting room.

isPublic

boolean

Flags if the asset should be Public.

accessRequestId

string

If audit is set to true you can specify an accessRequestId to batch uploads to the waiting room. The accessRequestId is retrieved in the response of this endpoint, after you save the first asset of your batch.

requestorId

string

If audit is set to true you can specify a requestor ID (user ID) to identify the user uploading the asset to the waiting room.

accessType

string

enum

If audit is set to true you can specify an access type to define to which waiting room location the asset is uploaded to. The available locations are: Upload, Edit, Workflow approval (export), Shutterstock and Stock.

Allowed:

ISOPublicationDate

string

Date/time of publication in ISO08601-format.

publicationDate

string

DEPRECATED Date/time of publication in linked API user selected locale-format.

archiveDate

string

Archive date/time of the asset in ISO8601-format.

watermarkDate

string

Watermark datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

crc32

integer

CRC32 checksum of the original file, used for verification.

Headers

Content-Type

const

enum

required

Allowed:

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json