---
title: "Save as a new asset"
method: POST
path: "/api/v4/media/save/{importId}"
tags: ["Step 6 EITHER Save as a new asset"]
---

# Save as a new asset

`POST /api/v4/media/save/{importId}`

## Request

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

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.

## Path parameters

- `importId` string, required

## Headers

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

## Request body `application/x-www-form-urlencoded`

- object
  - `ISOPublicationDate` string: Date/time of publication in ISO08601-format.
  - `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.
  - `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.
  - `archiveDate` string: Archive date/time of the asset in ISO8601-format.
  - `audit` boolean: Flags if the asset should be sent to the waiting room.
  - `brandId` string, required: Brand id to save the asset to.
  - `categories` string: Comma-separated category ids of the asset.
  - `copyright` string: Copyright information of the asset.
  - `crc32` integer: CRC32 checksum of the original file, used for verification.
  - `description` string: Extended asset description.
  - `isPublic` boolean: Flags if the asset should be Public.
  - `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.
  - `name` string: Name of the asset.
  - `publicationDate` string: *DEPRECATED* Date/time of publication in linked API user selected locale-format.
  - `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.
  - `tags` string: Comma-separated list of tags of the asset.
  - `watermarkDate` string: Watermark datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

## Response `201`

Created

- unknown

## Other responses

- `303`: Import not converted yet, please poll
- `400`: Bad Request
- `403`: Access denied
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/bynder/apis/upload-assets.md) - [All operations](https://skmtc.dev/bynder/apis/upload-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/upload-assets/revisions/05062b65fc98?raw)