PIpinterest
business_access_assets

Assign/Update partner asset permissions

Changed on

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

Request

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"
      ]
    }
  ]
}

Changes

  • v5b698c180678aRevision changes
    • warning

      added the new AD_ACCOUNT enum value to the // response property for the response status

    • warning

      added the new ASSET_GROUP enum value to the // response property for the response status

    • warning

      added the new CATALOG enum value to the // response property for the response status

    • warning

      added the new CONVERSION_SEGMENT enum value to the // response property for the response status

    • warning

      added the new CONVERSION_TAG enum value to the // response property for the response status

    • warning

      added the new MERCHANT enum value to the // response property for the response status

    • warning

      added the new PINNER_LIST enum value to the // response property for the response status

    • warning

      added the new PROFILE enum value to the // response property for the response status

    • info

      added the new BIZ_PINNER_LIST_SHARER enum value to the request property ///

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • v543134ca41f18Revision changes
    • info

      added the new CONSUMER_USER enum value to the request property ///