---
title: "Delete asset groups."
method: DELETE
path: "/businesses/{business_id}/asset_groups"
tags: ["business_access_assets"]
---

# Delete asset groups.

`DELETE /businesses/{business_id}/asset_groups`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/asset_groups`
- Auth: OAuth 2
  - Authorization code: `https://www.pinterest.com/oauth/`
  - Token URL: `https://api.pinterest.com/v5/oauth/token` scopes: `biz_access:read`, `biz_access:write`
- TypeScript: <https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/businesses/:business_id/asset_groups/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a batch of asset groups.

## Path parameters

- `business_id` string, required

## Request body

- AssetGroupDeletionDelete
  - `asset_groups_to_delete` PinterestLibIntegerFormatType[], required

## Response `200`

The request has succeeded.

- AssetGroupDeletion
  - `deleted_asset_groups` string[]
  - `exceptions` AssetGroupDeleteError[], nullable
    - `asset_group_id` string: Asset group id of the exception.
    - `code` integer: Error code associated with the error deleting asset group.
    - `message` string: Error message associated with the error deleting asset group.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a`: 4 info
  - removed the non-success response with the status `400`
  - the response optional property `deleted_asset_groups` became read-only for the status `200`
  - the response optional property `exceptions` became read-only for the status `200`
  - the `deleted_asset_groups/items/` response's property pattern `^\d+$` was removed for the status `200`
- **2024-08-14** (v5) `89c27ed39cfd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/businesses/:business_id/asset_groups/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/b698c180678a?raw)