# Update account document access

URL: /en/docs/api/v1/accounts/id/documents/patch
Last Updated: 2026-07-30T21:15:30.471Z

## Description
No description available.

## Available Actions
- Execute PATCH request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### PATCH /api/v1/accounts/{id}/documents

**Update account document access**

Update which documents are shared with a specific account. Supports bulk addition and removal of document access.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Path parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | Yes | Account ID |

**Request body** (`application/json`) - required:

- `ids` (array of string (uuid), required): Array of document IDs to share with the account

Example (Share multiple documents with account):

```json
{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002",
    "550e8400-e29b-41d4-a716-446655440003"
  ]
}
```

Example (Share single document):

```json
{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440001"
  ]
}
```

Example (Update shared document list):

```json
{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440004",
    "550e8400-e29b-41d4-a716-446655440005"
  ]
}
```

**Responses:**

- `200` - Account document access updated successfully
  - `success` (boolean)
  - `data` (object)
    - `shared_count` (integer): Number of documents now shared with account
    - `message` (string)
- `400` - Bad Request - validation failed or no document IDs provided
  - `error` (string)
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Account not found
- `500` - Internal server error

**Code samples:**

cURL:

```bash
curl -X PATCH "https://app.orbiqhq.com/api/v1/accounts/{id}/documents" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```