# PATCH /companies/:id

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

Update an existing company. Only include fields you want to change. Every successful PATCH emits a field-level audit row to crm_field_change_log (viewable at /data/crm-logs with the crm_audit:read scope). Legacy alias: PATCH /customers/:id.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Company ID |
| `name` | body | string | no | Company / organisation name |
| `email` | body | string | no | Primary email |
| `phone` | body | string | no | Mobile number in E.164 format. Landlines will be rejected -- use the landline field. |
| `landline` | body | string | no | Landline / office phone number in E.164 format. Set to null to clear. |
| `industry` | body | string | no | Industry sector |
| `website` | body | string | no | Website URL |
| `notes` | body | string | no | Notes |
| `metadata` | body | object | no | Custom field values as { field_id: value } pairs. Replaces entire metadata object -- read first with GET /companies/:id and merge locally. Reserved key: "quick_links" stores per-company Quick Link URLs as { <type-uuid>: <url> }. UUID-shaped keys at metadata root are rejected (400). |

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