# POST /files/:id/publish

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

Publish a private document to a public URL via R2. Creates a publicly accessible copy. Returns public_url.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Document file ID (type=document only) |

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