v1

latestOpenAPI 3.1.02026-07-2419782400.4 KB

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}

Path parameters

importIdstring required

Example:00000000-0000-0000-0000-000000000000

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

Headers

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

Response

Created

{"stackTrail":"paths:/api/v4/media/save/{importId}:post:responses:201:content:application/json:schema","oasType":"schema","type":"unknown","example":{"accessRequestId":"00000000-0000-0000-0000000000000000","mediaid":"00000000-0000-0000-0000000000000000","batchId":"00000000-0000-0000-0000000000000000","success":true,"mediaitems":[{"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","destination":"___URL_TO_BYNDER_CDN___"}]}}

Example response

{
  "accessRequestId": "00000000-0000-0000-0000000000000000",
  "mediaid": "00000000-0000-0000-0000000000000000",
  "batchId": "00000000-0000-0000-0000000000000000",
  "success": true,
  "mediaitems": [
    {
      "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",
      "destination": "___URL_TO_BYNDER_CDN___"
    }
  ]
}