Partially update organization

Partially updates an organization. Only the fields you provide will be updated; all other fields remain unchanged. This is the recommended way to update organizations when you only need to change specific fields.

When to use: Use this endpoint for partial updates (changing only specific fields). For full updates (replacing all fields), use PUT /organizations/ instead.

Available fields: All organization fields can be updated, including:

Basic info: name, shortName, icon, type, color, legalForm, description
Contact details: address fields, phone, fax, email, website
Legal info: taxNumber, registrationNumber, registrationCourt
Business: startOfCollaboration, isActive (via full update)
Invoice settings: hourRate, invoiceDueDays, reminder fees, interest rates, invoiceLanguage
Document settings: table of contents, title page, heading style, default contact
Custom data: customFields, keyed by configured organization custom-field IDs; values must match each definition type and do not create native relationships or behavior

Updating the logo:

Call POST /api/public/workspace/upload to upload the new logo file
Use the returned file ID in the logoId field
To remove the logo, set logoId to null

Behavior:

Omitted fields remain unchanged
Provided fields replace existing values
Set fields to null to clear them (where allowed)
Date fields should be provided in ISO format (YYYY-MM-DD)

What is returned: The complete updated organization object with all fields and computed values.

Note: This endpoint requires the Organizations.edit permission. The organization must exist in your workspace and not be deleted.

PATCH/organizations/{id}

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Request body

requiredapplication/json

addressCitystring

City

addressCountrystring

Country

addressHouseNumberstring

House number

addressStreetstring

Street address

addressZipstring

ZIP/Postal code

baseInvoiceInterestnumber

Base interest rate percentage (0-1000) used as the foundation for calculating default interest. Typically set by central banks (e.g., ECB, Bundesbank) and changes every six months. The final interest rate is baseInvoiceInterest + invoiceInterest.

colorstring

Hex color code used to visually distinguish this organization in lists, projects, and throughout the application (required)

createProjectboolean

Create a default project for this organization (internal use only)

customFieldsobject

Custom field values as key-value pairs. Keys should match custom field IDs configured in workspace settings. Values must match the field type (string, number, boolean, date, etc.). Use the GET /administration/organization-settings/custom-fields endpoint to retrieve available custom fields and their configurations.

emailstring

Email address

enableInvoiceInterestboolean

Whether to charge interest on overdue invoices. Overrides workspace default. Set to true to enable, false to disable.

enableInvoiceReminderFeeboolean

Whether to charge a reminder fee for overdue invoices. Overrides workspace default. Set to true to enable, false to disable.

faxNumberstring

Fax number

hourRatenumber

Customer-specific hourly rate used for all billable time entries for this organization. Overrides workspace default. Used when creating invoices.

iconstring

Icon identifier for visual representation in lists and projects. Must be in the format `:icon_name:` (e.g., `:building:`, `:office:`, `:factory:`). Use standard emoji short names or custom icon names created in the workspace.

invoiceDueDaysnumber

Number of days after invoice date until payment is due. Valid range: 1-120. Overrides workspace default for this organization.

invoiceInterestnumber

Interest rate percentage (0-1000) added to baseInvoiceInterest to calculate the total default interest rate. According to BGB §288: typically +5% for private customers, +9% for businesses. Final rate = baseInvoiceInterest + invoiceInterest.

invoiceLanguagestring

Language code used for generating invoices and reminders for this organization (e.g., "en", "de", "fr"). Overrides workspace default.

invoiceReminderFeenumber

Amount charged as a reminder fee for overdue invoices. Valid range: 0-1000. Only applies if enableInvoiceReminderFee is true.

legalFormstring

Legal company form or structure (e.g., "GmbH", "AG", "LLC", "Inc.", "Ltd.")

logoIdstring

UUID of the uploaded logo file. To upload a logo: 1) Call POST /api/public/workspace/upload to upload the file, 2) Use the returned file ID here. The logo will appear in organization lists and project views.

namestring

Full legal name of the organization (required)

parentOrganizationIdstring

UUID of the parent organization. Only top-level organizations (without a parent) can be selected as parents. Enables one-level hierarchical organization structure.

phoneNumberstring

Phone number

projectDocumentDefaultContactUserIdstring

UUID of the organization member (contact person) who will be automatically set as the recipient for new project documents (quotes, order confirmations, etc.) created for this organization.

projectDocumentEnableTocboolean

Whether to automatically include a table of contents in project documents (quotes, requirement documents, contracts) for this organization. Overrides workspace default.

projectDocumentHeadingStylestring

Formatting style for headings in project documents (e.g., "Sequential", "Normal"). Controls the hierarchy and appearance of document headings. Overrides workspace default.

projectDocumentTitlePageboolean

Whether to include a title/cover page in project documents for this organization. Overrides workspace default.

registrationCourtstring

Registration court

registrationNumberstring

Registration number

shortDescriptionstring

Short description of the organization

shortNamestring

Short abbreviation for the organization (3-5 characters, alphanumeric only). Used in projects and lists for quick identification. If not provided, will be auto-generated from the organization name.

max length 5

startOfCollaborationstring<date>

Date when the business relationship with this organization started. Format: ISO 8601 date (YYYY-MM-DD).

tagsstring[]

Array of tag UUIDs to categorize this organization. Tags enable cross-project organization and filtering. Use an empty array to remove all tags.

taxNumberstring

Tax identification number

typestring

Type of organization defining the business relationship. Options: Customer (existing business partner), Prospect (potential customer), Supplier (external provider), Partner (strategic partner), ServiceProvider, Investor, Competitor, GovernmentAgency, EducationalInstitution, Target (target customer group).

Allowed:CustomerProspectTargetPartnerSupplierServiceProviderInvestorCompetitorGovernmentAgencyEducationalInstitution

websitestring

Website URL

Responses

200

addressCityobject

City

addressCountryobject

Country

addressHouseNumberobject

House number

addressStreetobject

Street address

addressZipobject

ZIP/Postal code

baseInvoiceInterestobject

Base invoice interest rate

colorstringrequired

Organization color (hex code)

createdAtstringrequired

Creation timestamp

customFieldsobject

Custom field values as key-value pairs. Keys match custom field IDs configured in workspace settings. Values match the field type (string, number, boolean, date, etc.). Use the GET /administration/organization-settings/custom-fields endpoint to retrieve available custom fields.

emailobject

Email address

enableInvoiceInterestobject

Enable invoice interest

enableInvoiceReminderFeeobject

Enable invoice reminder fee

faxNumberobject

Fax number

hourRateobject

Hourly rate

iconobject

Icon identifier

idstringrequired

Organization ID

invoiceDueDaysobject

Invoice due days

invoiceInterestobject

Invoice interest rate

invoiceLanguageobject

Invoice language code

invoiceReminderFeeobject

Invoice reminder fee amount

isActivebooleanrequired

Whether organization is active

legalFormobject

Legal form

logoUrlobject

Logo URL (publicly accessible)

namestringrequired

Organization name

parentOrganizationIdobject

Parent organization ID (for hierarchical organization structure)

parentOrganizationNameobject

Parent organization name

phoneNumberobject

Phone number

projectDocumentDefaultContactUserIdobject

Default contact user ID for project documents

projectDocumentEnableTocobject

Enable table of contents in project documents

projectDocumentHeadingStyleobject

Heading style for project documents

projectDocumentTitlePageobject

Show title page in project documents

registrationCourtobject

Registration court

registrationNumberobject

Registration number

shortDescriptionobject

Short description

shortNameobject

Short identifier

startOfCollaborationstring<date>

Start of collaboration date

tagsstring[]

Array of tag UUIDs assigned to this organization. Tags enable cross-project organization and filtering.

taxNumberobject

Tax identification number

typestringrequired

Organization type

Allowed:CustomerProspectTargetPartnerSupplierServiceProviderInvestorCompetitorGovernmentAgencyEducationalInstitution

updatedAtstringrequired

Last update timestamp

websiteobject

Website URL

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

Request

curl -X PATCH "https://leadtime.app/api/public/organizations/string" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "addressCity": "New York",
  "addressCountry": "USA",
  "addressHouseNumber": "42A",
  "addressStreet": "123 Main St",
  "addressZip": "10001",
  "baseInvoiceInterest": 3,
  "color": "#FF5733",
  "createProject": false,
  "customFields": {
    "customField1": "value1",
    "customField2": 123
  },
  "email": "contact@acme.com",
  "enableInvoiceInterest": false,
  "enableInvoiceReminderFee": true,
  "faxNumber": "+1234567891",
  "hourRate": 150,
  "icon": ":building:",
  "invoiceDueDays": 30,
  "invoiceInterest": 5,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5,
  "legalForm": "GmbH",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Acme Corporation",
  "parentOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
  "phoneNumber": "+1234567890",
  "projectDocumentDefaultContactUserId": "123e4567-e89b-12d3-a456-426614174000",
  "projectDocumentEnableToc": true,
  "projectDocumentHeadingStyle": "classic",
  "projectDocumentTitlePage": true,
  "registrationCourt": "Munich District Court",
  "registrationNumber": "HRB 12345",
  "shortDescription": "Leading software development company",
  "shortName": "ACME",
  "startOfCollaboration": "2024-01-01",
  "tags": [
    "123e4567-e89b-12d3-a456-426614174000",
    "223e4567-e89b-12d3-a456-426614174001"
  ],
  "taxNumber": "DE123456789",
  "type": "Customer",
  "website": "https://acme.com"
}'

const response = await fetch("https://leadtime.app/api/public/organizations/string", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "addressCity": "New York",
  "addressCountry": "USA",
  "addressHouseNumber": "42A",
  "addressStreet": "123 Main St",
  "addressZip": "10001",
  "baseInvoiceInterest": 3,
  "color": "#FF5733",
  "createProject": false,
  "customFields": {
    "customField1": "value1",
    "customField2": 123
  },
  "email": "contact@acme.com",
  "enableInvoiceInterest": false,
  "enableInvoiceReminderFee": true,
  "faxNumber": "+1234567891",
  "hourRate": 150,
  "icon": ":building:",
  "invoiceDueDays": 30,
  "invoiceInterest": 5,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5,
  "legalForm": "GmbH",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Acme Corporation",
  "parentOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
  "phoneNumber": "+1234567890",
  "projectDocumentDefaultContactUserId": "123e4567-e89b-12d3-a456-426614174000",
  "projectDocumentEnableToc": true,
  "projectDocumentHeadingStyle": "classic",
  "projectDocumentTitlePage": true,
  "registrationCourt": "Munich District Court",
  "registrationNumber": "HRB 12345",
  "shortDescription": "Leading software development company",
  "shortName": "ACME",
  "startOfCollaboration": "2024-01-01",
  "tags": [
    "123e4567-e89b-12d3-a456-426614174000",
    "223e4567-e89b-12d3-a456-426614174001"
  ],
  "taxNumber": "DE123456789",
  "type": "Customer",
  "website": "https://acme.com"
})
});

import requests

response = requests.patch(
    "https://leadtime.app/api/public/organizations/string",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "addressCity": "New York",
  "addressCountry": "USA",
  "addressHouseNumber": "42A",
  "addressStreet": "123 Main St",
  "addressZip": "10001",
  "baseInvoiceInterest": 3,
  "color": "#FF5733",
  "createProject": False,
  "customFields": {
    "customField1": "value1",
    "customField2": 123
  },
  "email": "contact@acme.com",
  "enableInvoiceInterest": False,
  "enableInvoiceReminderFee": True,
  "faxNumber": "+1234567891",
  "hourRate": 150,
  "icon": ":building:",
  "invoiceDueDays": 30,
  "invoiceInterest": 5,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5,
  "legalForm": "GmbH",
  "logoId": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Acme Corporation",
  "parentOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
  "phoneNumber": "+1234567890",
  "projectDocumentDefaultContactUserId": "123e4567-e89b-12d3-a456-426614174000",
  "projectDocumentEnableToc": True,
  "projectDocumentHeadingStyle": "classic",
  "projectDocumentTitlePage": True,
  "registrationCourt": "Munich District Court",
  "registrationNumber": "HRB 12345",
  "shortDescription": "Leading software development company",
  "shortName": "ACME",
  "startOfCollaboration": "2024-01-01",
  "tags": [
    "123e4567-e89b-12d3-a456-426614174000",
    "223e4567-e89b-12d3-a456-426614174001"
  ],
  "taxNumber": "DE123456789",
  "type": "Customer",
  "website": "https://acme.com"
},
)

Response

{
  "addressCity": "New York",
  "addressCountry": "USA",
  "addressHouseNumber": "42A",
  "addressStreet": "123 Main St",
  "addressZip": "10001",
  "baseInvoiceInterest": 3,
  "color": "#FF5733",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "customFields": {
    "customField1": "value1",
    "customField2": 123
  },
  "email": "contact@acme.com",
  "enableInvoiceInterest": false,
  "enableInvoiceReminderFee": true,
  "faxNumber": "+1234567891",
  "hourRate": 150,
  "icon": "building",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "invoiceDueDays": 30,
  "invoiceInterest": 5,
  "invoiceLanguage": "en",
  "invoiceReminderFee": 5,
  "isActive": true,
  "legalForm": "GmbH",
  "logoUrl": "https://app.example.com/api/files/public/123e4567-e89b-12d3-a456-426614174000",
  "name": "Acme Corporation",
  "parentOrganizationId": "123e4567-e89b-12d3-a456-426614174000",
  "parentOrganizationName": "B. Braun",
  "phoneNumber": "+1234567890",
  "projectDocumentDefaultContactUserId": "123e4567-e89b-12d3-a456-426614174000",
  "projectDocumentEnableToc": true,
  "projectDocumentHeadingStyle": "classic",
  "projectDocumentTitlePage": true,
  "registrationCourt": "Munich District Court",
  "registrationNumber": "HRB 12345",
  "shortDescription": "Leading software development company",
  "shortName": "ACME",
  "startOfCollaboration": "2024-01-01",
  "tags": [
    "123e4567-e89b-12d3-a456-426614174000",
    "223e4567-e89b-12d3-a456-426614174001"
  ],
  "taxNumber": "DE123456789",
  "type": "Customer",
  "updatedAt": "2024-01-15T12:30:00.000Z",
  "website": "https://acme.com"
}