---
title: "Modify asset"
method: POST
path: "/api/v4/media/{id}"
tags: ["Media ID"]
---

# Modify asset

`POST /api/v4/media/{id}`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/v4/media/{id}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: ``, `MEDIAEDIT`, `MARKPUBLIC`

Requires the **MEDIAEDIT** security role. Requires the **MARKPUBLIC** security role in order to change an asset's isPublic state.

**Custom thumbnails**

To set a custom thumbnail, first upload the thumbnail image using the [Modern Stack File Upload](https://api.bynder.com/reference/modern-stack-file-upload) flow, then call this endpoint with the returned file id as `customThumbnailFileId`. To remove an existing custom thumbnail and revert to the automatically generated one, call this endpoint with `removeCustomThumbnail=true`. The two fields are mutually exclusive.

## Path parameters

- `id` string, required

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

- object
  - `archive` boolean: Indicating the archived state of the asset.
  - `archiveDate` string, date-time: Archive datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.
  - `brandId` string: Id of the brand to save the asset to.
  - `copyright` string: Copyright information of the asset.
  - `customThumbnailFileId` string: The file id of the custom thumbnail to be set for the asset. Custom thumbnails must first be uploaded by following the steps described in the [Modern Stack File Upload](https://api.bynder.com/reference/modern-stack-file-upload) documentation; use the `fileId` returned by that flow. Cannot be combined with `removeCustomThumbnail`.
  - `datePublished` string, date-time: Publication datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.
  - `description` string: Asset description.
  - `id` string: Asset id.
  - `isPublic` boolean: Indicating the public state of the asset. Warning irreversible, once changed to true it cannot be changed back.
  - `limited` boolean: Indicating the limit state of the asset.
  - `limitedDate` string, date-time: Limit datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.
  - `metaproperty` object: Mapping of metaproperty UUIDs to the option value(s) to set on the asset. Each value may be provided as option label, option DB name, or option UUID. For multi-select metaproperties, pass multiple values as a comma-separated string. <br><br>In x-www-form-urlencoded requests, fields are sent as `metaproperty.<metaproperty_uuid>=<value1>,<value2>`.
  - `name` string: Name of the asset, beware the asset will have no name when this is empty.
  - `removeCustomThumbnail` boolean: Remove the current custom thumbnail from the asset, reverting to the automatically generated thumbnail. Cannot be combined with `customThumbnailFileId`.
  - `tags` string: Comma-separated tags. Tags will overwrite the current tags list.
  - `watermarkDate` string, date-time: Watermark datetime. ISO8601 format: yyyy-mm-ddThh:mm:ssZ.

## Response `202`

Accepted

- object
  - `message` string
  - `statuscode` integer

## Other responses

- `403`: Access denied
- `404`: Media not found

---

[API](https://skmtc.dev/bynder/apis/asset-management.md) - [All operations](https://skmtc.dev/bynder/apis/asset-management/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/asset-management/revisions/ac468a599f2d?raw)