v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
business_access_assets

Assign/Update partner asset permissions

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.

patch/businesses/{business_id}/partners/assets

Path parameters

business_idstring required

Unique identifier of the requesting business.

Request body

Response

The request has succeeded.

Example response

{
  "items": [
    {
      "asset_id": "549755885175",
      "asset_type": "AD_ACCOUNT",
      "partner_id": "140943737684417",
      "permissions": [
        "FINANCE_MANAGER",
        "CATALOGS_MANAGER",
        "AUDIENCE_MANAGER"
      ]
    }
  ]
}