---
title: "Change invoice settings"
method: PUT
path: "/v1/workspaces/{workspaceId}/invoices/settings"
tags: ["Invoice"]
---

# Change invoice settings

`PUT /v1/workspaces/{workspaceId}/invoices/settings`

To update settings, first perform a `GET` request to ``/v1/workspaces/{workspaceId}/invoices/settings`` to retrieve the object's current state. Next, modify only the specific fields you wish to change while leaving the rest of the structure intact. Finally, send that modified payload back to the server using a PUT request to overwrite and update the resource. 

Important: You must echo back the full payload returned by the initial `GET` request; Because PUT replaces the entire resource, any omitted fields will be overwritten with default values or cleared entirely.

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- UpdateInvoiceSettingsRequestV1
  - `defaults` InvoiceDefaultSettingsRequestV1 — Represents an invoice default settings object.
    - `companyId` string — Represents company identifier across the system.
    - `dueDays` integer — Represents an invoice number of due days.
    - `itemTypeId` string — Represents item type identifier across the system.
    - `notes` string, required — Represents an invoice note.
    - `subject` string, required — Represents an invoice subject.
    - `tax2Percent` number, double — Represents a tax amount in percentage.
    - `taxPercent` number, double — Represents a tax amount in percentage.
    - `taxType` 'COMPOUND' | 'SIMPLE' | 'NONE' — Represents a tax type.
  - `exportFields` InvoiceExportFieldsRequest — Represents an invoice export fields object.
    - `itemType` boolean — Indicates whether to export item type.
    - `quantity` boolean — Indicates whether to export quantity.
    - `rtl` boolean — Indicates whether to export RTL.
    - `tax` boolean — Indicates whether to export tax.
    - `tax2` boolean — Indicates whether to export tax2.
    - `unitPrice` boolean — Indicates whether to export unit price.
  - `labels` LabelsCustomizationRequest, required — Represents a label customization object.
    - `amount` string, required — Represents invoice amount label.
    - `billFrom` string, required — Represents invoice bill from label.
    - `billTo` string, required — Represents invoice bill to label.
    - `description` string, required — Represents invoice description label.
    - `discount` string, required — Represents invoice discount amount label.
    - `dueDate` string, required — Represents invoice due date label.
    - `issueDate` string, required — Represents invoice issue date label.
    - `itemType` string, required — Represents invoice item type label.
    - `notes` string, required — Represents invoice notes label.
    - `paid` string, required — Represents invoice paid amount label.
    - `quantity` string, required — Represents invoice quantity label.
    - `subtotal` string, required — Represents invoice subtotal label.
    - `tax` string, required — Represents invoice tax amount label.
    - `tax2` string, required — Represents invoice tax 2 amount label.
    - `total` string, required — Represents invoice total amount label.
    - `totalAmountDue` string, required — Represents invoice total amount due label.
    - `unitPrice` string, required — Represents invoice unit price label.

## Response `200`

OK

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)