# POST /notepads/:id/acl

**Resource:** [Notepads](./notepads.md)  
**Scopes:** `notepads:write`  
**Write operation:** yes

Grant a user or role access to a restricted notepad. Set visibility to "restricted" first, then add ACL entries.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Notepad ID |
| `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) |

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