--- title: "Updates customer metadata" method: PUT path: "/customers/{customer_id}/metadata" tags: ["Customers"] --- # Updates customer metadata `PUT /customers/{customer_id}/metadata` ## Request - Base URL: `https://api.rillet.com` - URL: `https://api.rillet.com/customers/{customer_id}/metadata` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Full replacement: every active key omitted from the request is cleared. To set or clear individual keys without disturbing the rest, use patch-customer-metadata instead. Null, empty, and whitespace-only values clear one key. Unknown keys, archived keys, and definitions not assigned to customers fail the entire request with a 400. Metadata-only changes are recorded in the audit log but do not trigger customer.updated webhooks or customer integration syncs. ## Path parameters - `customer_id` string, uuid, required ## Request body - UpdateMetadataValuesRequest - `metadata` object, required: Values keyed by definition key. A full replacement: every active key omitted here is cleared, and null, empty, or whitespace-only values clear one key. Values are trimmed; TEXT values allow at most 256 characters and no line breaks. ## Response `200` OK - MetadataValues - `metadata` object, required: Values keyed by definition key. A key with no value on this record is omitted. Use list-all-metadata-definitions for definition names, types and status. ## Other responses - `default`: Error ## Changes - **2026-11-03** `c393d0102005`: 1 info - endpoint added [Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/customers/:customer_id/metadata/put.md) --- [API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)