---
title: "Edit asset(s)"
method: PATCH
path: "/media_library/businesses/{business_id}/assets"
tags: ["media_library"]
---

# Edit asset(s)

`PATCH /media_library/businesses/{business_id}/assets`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/media_library/businesses/{business_id}/assets`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `ads:write`

Edit one or more media library assets for a business. Assets are
reusable image or video creatives at the business level, not Pins. Use
this to rename assets and update their tags in **Media library**.
This does not replace the image or video file.

The editable fields are `name` and `tags`. Omitting a field, or sending
it as `null`, leaves it unchanged. To change tags, send the full
replacement list; send an empty list (`[]`) to remove all tags. The name
can be changed but not cleared. Each entry must set at least one of
`name` or `tags`, and at most 100 assets may be edited per request.

Per-asset outcomes are reported in the response body, not in the HTTP
status: an authorized, well-formed request returns 200 even when some or
all of the requested assets were not updated. Read `status` for the
overall outcome and `results` for each asset. Entries in `results` are
returned in the same order as the request `assets`. A successful entry
carries `asset.asset_id`; on failure the `asset` snapshot is omitted, so
match failures to the request by position.

Access requires the token user to be the business owner or to have a
[Business Access](https://help.pinterest.com/en/business/article/business-manager-overview)
role with media library edit access: Admin, Campaign Manager, or Profile Publisher.

## Path parameters

- `business_id` string, required

## Request body

- MediaLibraryAssetsUpdateRequest: Bulk update request: the assets to update. At most 100 assets may be updated per request.
  - `assets` MediaLibraryAssetUpdateEntry[], required: Assets to update. Each entry is identified by its `asset_id`.
    - `asset_id` string, required: Unique identifier of the asset to update.
    - `name` string, nullable: New asset name. Omit or send `null` to leave it unchanged; the name cannot be cleared.
    - `tags` string[], nullable: New list of tags, replacing the current tags. Omit or send `null` to leave them unchanged; send an empty list to remove all tags.

## Response `200`

The request has succeeded.

- MediaLibraryAssetsUpdateResult: Bulk update result: the overall outcome plus the per-asset results.
  - `status` 'SUCCESS' | 'PARTIAL_SUCCESS' | 'ERROR', required: Overall outcome of a bulk operation.
  - `success_count` integer, required: Number of successfully updated assets.
  - `failure_count` integer, required: Number of assets that failed to update.
  - `results` MediaLibraryUpdateAssetResult[], required: Per-asset results, in the same order as the request `assets`.
    - `status` 'SUCCESS' | 'ERROR', required: Asset operation status for a single item in a bulk operation.
    - `error_code` 'ASSET_NOT_FOUND' | 'INTERNAL_ERROR' | 'INVALID_ARGUMENT' | 'MEDIA_NOT_FOUND' | 'MEDIA_NOT_READY' | 'MEDIA_UPLOAD_FAILED': Why the asset operation failed. Omitted when the status is `SUCCESS`.
    - `message` string, required: Result message for the asset operation. Empty on success.
    - `asset` MediaLibraryUpdateAssetSummary: Snapshot of the updated asset. Present on success; omitted when the asset could not be updated.
      - `asset_id` string, required: Unique identifier of the asset.
      - `business_id` string, required: Identifier of the business that owns the asset.
      - `asset_type` 'IMAGE' | 'VIDEO', required: Type of media library asset.
      - `name` string, required: Name of the asset.
      - `has_been_promoted` boolean, required: Whether the asset has been used in a pin promotion.
      - `file_extension` 'JPG' | 'PNG' | 'BMP' | 'TIFF' | 'WEBP' | 'MOV' | 'MP4' | 'M4V' | 'AVIF', required: File extension type of the uploaded media.
      - `tags` string[], required: List of tags associated with the asset.
      - `created_at` integer, required: Unix timestamp (milliseconds) when the asset was created.
      - `updated_at` integer, required: Unix timestamp (milliseconds) when the asset was last updated.

## Other responses

- `400`: The request could not be understood by the server due to unexpected data.
- `401`: Authentication is required and has either failed or not been provided.
- `403`: The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404`: The requested resource could not be found on this server.
- `429`: The user has sent too many requests in a given amount of time and is being rate limited.
- `default`: An unexpected error response.

## Changes

- **2026-11-19** (v5) `cc5c1b75cc2c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/media_library/businesses/:business_id/assets/patch.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/19899fd1c8f3?raw)
