PIpinterest
business_access_invite

Create a request to access an existing partner's assets.

Changed on

Create a request to access an existing partner's assets with the specified permissions. The request will be sent to the partner for approval. The assets that can be requested are ad accounts and profiles.

post/businesses/{business_id}/requests/assets/access

Request

Path parameters

business_idstring required

Unique identifier of the requesting business.

Request body

Example request

{
  "asset_requests": [
    {
      "asset_id_to_permissions": {
        "549760723247": [
          "ANALYST"
        ],
        "549760723248": [
          "ANALYST",
          "ADMIN"
        ],
        "809944451643622187": [
          "PROFILE_PUBLISHER"
        ]
      }
    }
  ]
}

Response

The request has succeeded.

invitesobject

An object mapping each partner id to the asset access request id. Only one request id is returned per partner.

Example response

{
  "invites": {
    "766456567741825556": "5349280584552211583",
    "733242520489967216": "5349280584552211845"
  }
}

Changes

  • v5b698c180678aRevision changes
    • 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

    • info

      added the success response with the status

  • v543134ca41f18Revision changes
    • info

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