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

# Remove asset(s)

`DELETE /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`

Delete one or more media library assets for a business. Assets are
reusable image or video creatives at the business level, not Pins.
At most 100 assets per request. Duplicate IDs in the same request are
counted once, and an ID that is already deleted counts as a success.
After a successful delete, GET for that `asset_id` returns 404.

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 deleted. Read `status` for the
overall outcome and `failures` for the reason each asset was not
deleted.

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

## Query parameters

- `asset_ids` PinterestLibIntegerFormatType[], required

## Response `200`

The request has succeeded.

- MediaLibraryAssetsDeleteResult: The result of a bulk delete of media library assets.
  - `status` 'SUCCESS' | 'PARTIAL_SUCCESS' | 'ERROR', required: `SUCCESS` when every requested asset was deleted, `PARTIAL_SUCCESS` when only some were, `ERROR` when none were.
  - `deleted_count` integer, required: Number of assets that were successfully deleted. Already-deleted assets count as successes.
  - `deleted_asset_ids` PinterestLibIntegerFormatType[], required: IDs of the assets that were deleted.
  - `failed_count` integer, required: Number of assets that failed to delete.
  - `failures` MediaLibraryDeleteAssetFailure[], required: Per-asset failures. Empty when every requested asset was deleted.
    - `asset_id` string, required: ID of the asset that could not be deleted.
    - `error_code` 'ASSET_NOT_FOUND' | 'INTERNAL_ERROR' | 'INVALID_ARGUMENT' | 'MEDIA_NOT_FOUND' | 'MEDIA_NOT_READY' | 'MEDIA_UPLOAD_FAILED', required: Why the asset failed to delete.
    - `message` string, required: Result message for the failed asset operation.

## Other responses

- `204`: Resource deleted successfully.
- `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/delete.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)
