---
title: "Terminate business partnerships"
method: DELETE
path: "/businesses/{business_id}/partners"
tags: ["business_access_relationships"]
---

# Terminate business partnerships

`DELETE /businesses/{business_id}/partners`

## Request

- Base URL: `https://api.pinterest.com/v5`
- URL: `https://api.pinterest.com/v5/businesses/{business_id}/partners`
- 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/delete.ts> (a function with typed inputs; its response is checked against the schema)

Terminate partnerships between the specified partners and your business.
Note: You may only batch terminate partners of the same partner type.

## Path parameters

- `business_id` string, required

## Request body

- DeleteBusinessPartnersDelete
  - `partner_ids` BusinessPartnerIdType[], required: A list of partner ids to be deleted
  - `partner_type` 'INTERNAL' | 'EXTERNAL' | 'null', nullable

## Response `200`

The request has succeeded.

- DeleteBusinessPartners
  - `deleted_partners` PinterestLibIntegerFormatType[]

## Other responses

- `404`: The requested resource could not be found on this server.
- `default`: An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a`: 2 breaking, 1 warning, 1 info
  - added `#/components/schemas/NullablePartnerType` to the `partner_type` request property `allOf` list
  - the `partner_type` request property type changed from `string` to no type
  - removed `#/components/schemas/BusinessRoleCheckMode, subschema #1` from the `partner_type` request property `allOf` list
  - the response optional property `deleted_partners` became read-only for the status `200`
- **2024-04-23** (v5) `f9321315766f`: 1 info
  - endpoint added

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