# POST /report-dashboards/:id/acl

**Resource:** [Reports](./reports.md)  
**Scopes:** `opportunities:read`  
**Write operation:** yes

Grant a user or role access to a restricted dashboard. Set visibility="restricted" on the dashboard first.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Dashboard UUID. |
| `principal_type` | body | string | yes | "user" or "role". |
| `principal_id` | body | string | yes | User UUID (when principal_type=user) or role name (when principal_type=role, e.g. "client_admin", "client_editor", "client_viewer"). |

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`