---
title: "Create a request to access an existing partner's assets."
method: POST
path: "/businesses/{business_id}/requests/assets/access"
tags: ["business_access_invite"]
---

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

`POST /businesses/{business_id}/requests/assets/access`

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.

## Path parameters

- `business_id` string, required

## Request body

- CreateAssetAccessRequestBody — An object containing a list of all the asset access requests
  - `asset_requests` CreateAssetAccessRequestItem[], required
    - `asset_id_to_permissions` AssetIdToPermissions, required — An object mapping asset ids to lists of business permissions. This can be used to setting/requesting permissions on various assets. If accepting an invite or request, this object would be used to grant asset permissions to the member or partner.
    - `partner_id` string, required — Unique identifier of a business partner to request asset access to.

## Response `200`

The request has succeeded.

- CreateAssetAccessRequestResponse
  - `exceptions` AssetAccessRequestError[] — A list of errors associated with the asset access requests. Will be returned if there is an error.
    - `code` integer — Error code associated with the error in requesting asset access.
    - `messages` string[]
  - `invites` object — An object mapping each partner id to the asset access request id. Only one request id is returned per partner.

## Other responses

- `201` — Resource create operation completed successfully.
- `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)