# Update a company

Partially update a company. Only provided fields will be updated.

- Omitted fields: Not modified (current value preserved)
- Provided fields: Updated to the new value
- Null values: Clear the field (set to null) where applicable

Endpoint: PATCH /companies/{id}
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    Resource ID (UUID) or client key
    Example: "550e8400-e29b-41d4-a716-446655440000"

## Request fields (application/json):

  - `name` (string)
    Company legal name
    Example: "Acme Logistics Inc"

  - `addressLine1` (string,null)
    Primary street address
    Example: "123 Main St"

  - `addressLine2` (string,null)
    Secondary address line
    Example: "Suite 400"

  - `city` (string,null)
    City name
    Example: "Chicago"

  - `country` (string,null)
    Country code or name
    Example: "USA"

  - `fax` (string,null)
    Fax number
    Example: "+1-555-0123"

  - `invoiceOnly` (boolean,null)
    Whether this company is used only for invoicing purposes

  - `invoiceVerbiage` (string,null)
    Custom text to include on invoices
    Example: "Please remit payment within 30 days"

  - `primaryContactName` (string,null)
    Name of primary contact person
    Example: "John Smith"

  - `primaryContactEmail` (string,null)
    Email address of primary contact
    Example: "john.smith@acmelogistics.com"

  - `primaryContactPhone` (string,null)
    Phone number of primary contact
    Example: "+1-555-0100"

  - `key` (string,null)
    Client-defined reference identifier
    Example: "ERP-COMPANY-ACME-001"

## Response 200 fields (application/json):

  - `object` (string)
    Object type identifier
    Enum: "COMPANY"

  - `id` (string, required)
    Unique company identifier
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `name` (string, required)
    Company legal name
    Example: "Acme Logistics Inc"

  - `addressLine1` (string,null)
    Primary street address
    Example: "123 Main St"

  - `addressLine2` (string,null)
    Secondary address line (suite, floor, etc.)
    Example: "Suite 400"

  - `city` (string,null)
    City name
    Example: "Chicago"

  - `country` (string,null)
    Country code or name
    Example: "USA"

  - `fax` (string,null)
    Fax number
    Example: "+1-555-0123"

  - `invoiceOnly` (boolean,null)
    Whether this company is used only for invoicing purposes

  - `invoiceVerbiage` (string,null)
    Custom text to include on invoices for this company
    Example: "Please remit payment within 30 days"

  - `primaryContactName` (string,null)
    Name of primary contact person
    Example: "John Smith"

  - `primaryContactEmail` (string,null)
    Email address of primary contact
    Example: "john.smith@acmelogistics.com"

  - `primaryContactPhone` (string,null)
    Phone number of primary contact
    Example: "+1-555-0100"

  - `createdBy` (any)
    User who created this company (full user details)

  - `key` (string,null)
    Client-defined reference identifier
    Example: "ERP-COMPANY-ACME-001"

  - `createdAt` (string, required)
    When the company was created
    Example: "2025-01-15T10:00:00Z"

  - `updatedAt` (string, required)
    When the company was last updated
    Example: "2025-01-15T14:30:00Z"

  - `deletedAt` (string,null)
    When the company was soft deleted (null if active)

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 404 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 409 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message