BYbynder
Step 6 EITHER Save as a new asset

Save as a new asset

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.

post/api/v4/media/save/{importId}

Request

  • Base URL
    https://your-bynder-domain
  • URL
    https://your-bynder-domain/api/v4/media/save/{importId}
  • Auth
    • OAuth 2
      Authorization code: https://your-bynder-domainDefaultValue/
      Client credentials
      Token URL: https://your-bynder-domainDefaultValue/token scopes: MEDIAUPLOAD, MEDIAUPLOADFORAPPROVAL
    • or API key in header Authorization

Path parameters

importIdstring required
Example:00000000-0000-0000-0000000000000000

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

Headers

Content-Type'application/x-www-form-urlencoded' required

Request body application/x-www-form-urlencoded

ISOPublicationDatestring

Date/time of publication in ISO08601-format.

accessRequestIdstring

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.

accessType'upload' | 'edit' | 'export' | 'shutterstock' | 'stock'

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.

archiveDatestring

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

auditboolean

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

brandIdstring required

Brand id to save the asset to.

categoriesstring

Comma-separated category ids of the asset.

copyrightstring

Copyright information of the asset.

crc32integer

CRC32 checksum of the original file, used for verification.

descriptionstring

Extended asset description.

isPublicboolean

Flags if the asset should be Public.

metapropertystring

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.

namestring

Name of the asset.

publicationDatestring

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

requestorIdstring

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.

tagsstring

Comma-separated list of tags of the asset.

watermarkDatestring

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

Example request

{
  "ISOPublicationDate": "2014-06-12T18:53:21.000Z",
  "accessRequestId": "00000000-0000-0000-0000000000000000",
  "accessType": "upload",
  "archiveDate": "2014-12-25T10:30:00.000Z",
  "audit": true,
  "brandId": "00000000-0000-0000-00000000000000000000",
  "categories": "00000000-0000-0000-0000000000000000,00000000-0000-0000-0000000000000000",
  "copyright": "Copyright (c) Example corp.",
  "crc32": 79764919,
  "description": "Extended asset description",
  "isPublic": true,
  "metaproperty": "metaproperty.00000000-0000-0000-0000000000000000=00000000-0000-0000-0000000000000000,00000000-0000-0000-0000000000000000",
  "name": "Asset name",
  "publicationDate": "05-31-2010",
  "requestorId": "00000000-0000-0000-0000000000000000",
  "tags": "scenery,grassland,Holland",
  "watermarkDate": "2014-12-25T10:30:00.000Z"
}

Response

Created

unknown required

Example response

{
  "accessRequestId": "00000000-0000-0000-0000000000000000",
  "batchId": "00000000-0000-0000-0000000000000000",
  "mediaid": "00000000-0000-0000-0000000000000000",
  "mediaitems": [
    {
      "destination": "___URL_TO_BYNDER_CDN___",
      "original": "final/00000000-0000-0000-0000000000000000/image.jpg"
    },
    {
      "destination": "___URL_TO_BYNDER_CDN___",
      "original": "final/00000000-0000-0000-0000000000000000/thul-image.jpg"
    },
    {
      "destination": "___URL_TO_BYNDER_CDN___",
      "original": "final/00000000-0000-0000-0000000000000000/mini-image.jpg"
    }
  ],
  "success": true
}

Changes

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