---
title: "Assign/Update partner asset permissions"
method: PATCH
path: "/businesses/{business_id}/partners/assets"
tags: ["business_access_assets"]
---

# Assign/Update partner asset permissions

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

Grant multiple partners access to assets and/or update multiple partner's exisiting permissions to an asset.
If your partner already had permissions on the asset, they will be overriden with the new permissions you assign to them.
To learn more about permission levels, visit https://help.pinterest.com/en/business/article/business-manager-overview

Note: Not all listed permissions are applicable to each asset type. For example, PROFILE_PUBLISHER would not be
applicable to an asset of type AD_ACCOUNT. The permission level PROFILE_PUBLISHER is only available to an asset of
the type PROFILE.

## Path parameters

- `business_id` string, required

## Request body

- UpdatePartnerAssetAccessBody — An object with a list of partner asset accesses to assign or update.
  - `accesses` UpdatePartnerAssetAccessItem[], required — List of partner asset accesses to assign or update.
    - `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.
    - `permissions` Permissions[], required — A non-empty array of permissions to assign to the partner.

## Response `200`

The request has succeeded.

- UpdatePartnerAssetsResultsResponseArray
  - `items` UpdatePartnerAssetsResult[] — List of assigned/updated partner asset access.
    - `asset_id` string — Unique identifier of a business asset.
    - `asset_type` 'AD_ACCOUNT' | 'MERCHANT' | 'PROFILE' | 'ASSET_GROUP' | 'PINNER_LIST' | 'CONVERSION_TAG' | 'CATALOG' | 'CONVERSION_SEGMENT' — Type of asset. Currently we only support AD_ACCOUNT, PROFILE, ASSET_GROUP and CATALOG.
    - `partner_id` string — Unique identifier of a business partner.
    - `permissions` string[] — Permission levels member or partner has on an asset.

## 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.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)