---
title: "Delete partner access to asset"
method: DELETE
path: "/businesses/{business_id}/partners/assets"
tags: ["business_access_assets"]
---

# Delete partner access to asset

`DELETE /businesses/{business_id}/partners/assets`

## Request

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

Terminate multiple partners' access to an asset. If
- partner_type=INTERNAL: You will terminate a partner's asset access to your business assets.
- partner_type=EXTERNAL: You will terminate your own access to your partner's business assets.

## Path parameters

- `business_id` string, required

## Request body

- DeletePartnerAssetAccessBody: An object with a list of partner asset accesses to delete.
  - `accesses` DeletePartnerAssetAccessItem[], required: List of partner asset accesses to delete.
    - `asset_id` string, required: Unique identifier of the business asset.
    - `partner_id` string, required: Unique identifier of a business partner to update asset access to.
    - `partner_type` 'INTERNAL' | 'EXTERNAL': If partner_type=INTERNAL, the deleted asset access is for the access the partner has to your business asset. If partner_type=EXTERNAL, the deleted asset access is for the access you have to the partner's business asset.

## Response `200`

The request has succeeded.

- DeletePartnerAssetAccessResultsResponseArray
  - `items` DeletePartnerAssetAccessResult[]: List of terminated partner asset accesses.
    - `asset_id` string: Unique identifier of a business asset.
    - `asset_type` string: Type of asset. Currently we only support AD_ACCOUNT, PROFILE, ASSET_GROUP and CATALOG.
    - `is_shared_partner` boolean: If is_shared_partner=FALSE, you terminated a partner's asset access to your business asset. If is_shared_partner=TRUE, you terminated your asset access to your partner's business asset.
    - `partner_id` string: Unique identifier of a business partner.
    - `permissions` string[]: Permission levels member or partner has on an asset.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2024-04-23** (v5) `f9321315766f`: 1 info
  - endpoint added

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