--- search: tags: - administration - PATCH seo: description: >- Updates document settings for the workspace. All fields are… Reference for the PATCH /administration/document-settings endpoint in the Leadtime Public API API. sidebar: badge: PATCH label: Update document settings title: Update document settings type: openapi-operation --- Updates document settings for the workspace. All fields are optional - only provided fields will be updated. **What are Document Settings?** Document settings control the appearance and formatting of all documents automatically generated by Leadtime, including letters, invoices, quotes, specifications, and project documents. **How to update document settings:** 1. **For file uploads** (logo, background images): - Upload image files using POST /api/public/workspace/upload - Get the file ID from the upload response - Use the file ID in the corresponding field (`documentLogoId`, `specificationBackgroundId`, etc.) - To remove a file, set the field to `null` 2. **For font selection**: Choose from available fonts (Inter, Degular, Roboto, Arimo, Open Sans, PT Sans, Oswald, EB Garamond, Permanent Marker, IBM Plex Mono) 3. **For project document options**: Set boolean flags and heading style enum values **Available heading styles:** - `Normal`: Headings without numbering - `Sequential`: Continuous numbering from level 1 (e.g., 1., 1.1., 1.1.1.) - `SequentialFromSecondLevel`: Top heading unnumbered, subchapters numbered (e.g., 1. Heading 2, 1.1. Heading 3) - `SequentialWithParagraphs`: Numbering with § prefix from level 2 (e.g., § 1., § 1.1.) - ideal for contracts **Background image recommendations:** - Recommended size: 820 × 600 pixels - Formats: PNG, JPG, or SVG - Used on cover pages of generated documents **Note:** This endpoint requires the `WsSettings.manageSettings` permission. Changes affect all documents generated after the update. Use GET endpoint to preview current settings.