> ## Documentation Index
> Fetch the complete documentation index at: https://developers.luccasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lucca API Changes

> New updates and improvements made to the Lucca API.

export const ChangelogItem = ({type, breaking = false, children}) => {
  const breakingHtml = breaking ? <span className="prose-sm rounded mint-capitalize mint-text-red-700 dark:mint-text-red-400">breaking change</span> : '';
  let color, label;
  switch (type) {
    case 'Added':
      color = 'green';
      label = type;
      break;
    case 'Changed':
      color = 'blue';
      label = type;
      break;
    case 'Deprecated':
      color = 'orange';
      label = type;
      break;
    case 'Removed':
      color = 'red';
      label = type;
      break;
    case 'Fixed':
      color = 'gray';
      label = type;
      break;
    case 'Security':
      color = 'purple';
      label = type;
      break;
    default:
      color = 'red';
      label = 'UNKNOWN';
      break;
  }
  return <table>
      <tr>
        <td style={{
    verticalAlign: 'top'
  }}>
          <span className={`prose-sm rounded p-1 mr-2 capitalize bg-${color}-400/20 text-${color}-700 dark:bg-${color}-400/20 dark:text-${color}-400`}>{label}</span></td>
        <td>
          {breakingHtml}
          <span className={'prose-sm rounded'}>{children}</span>
        </td>
      </tr>
    </table>;
};

<Update label="March 2026" description="v: 2024-11-01">
  ## Support For Write Requests on Departments

  <ChangelogItem type={'Added'}>
    Adds support for POST and PATCH requests on `/lucca-api/departments/{id?}`.
  </ChangelogItem>

  ## Organization Endpoints Are Now Out of Beta

  <ChangelogItem type={'Changed'}>
    API endpoints for legal-entities (read-only), business-establishments (read-only) and departments (read/write) are now out of beta.
  </ChangelogItem>

  ## Employee Attributes Added

  <ChangelogItem type={'Added'}>
    Support for read requests on `/lucca-api/employee-attributes/{id?}` and `/lucca-api/employee-attribute-definitions/{id?}`.
  </ChangelogItem>

  <ChangelogItem type={'Added'}>
    Support for read requests on `/lucca-api/taxonomies/{id?}` and `/lucca-api/taxonomy-labels/{id?}`.
  </ChangelogItem>
</Update>

<Update label="October 2025" description="v: 2024-11-01">
  ## Breaking Changes on GET /lucca-api/employments

  <ChangelogItem type={'Changed'} breaking={true}>
    Query parameter `?startsOn={date}` is replaced with `?start.date={date}`.
  </ChangelogItem>

  <ChangelogItem type={'Changed'} breaking={true}>
    Query parameter `?startsOn.between={date-range}` is replaced with `?start.date.between={date-range}`.
  </ChangelogItem>

  <ChangelogItem type={'Changed'} breaking={true}>
    Query parameter `?endsOn={date}` is replaced with `?end.date={date}`.
  </ChangelogItem>

  <ChangelogItem type={'Changed'} breaking={true}>
    Query parameter `?endsOn.between={date}` is replaced with `?end.date.between={date}`.
  </ChangelogItem>
</Update>

<Update label="July 2025" description="v: 2024-11-01">
  ## Breaking Changes on the employee-personal-record

  <ChangelogItem type={'Changed'}>
    The `bankAccount` object property is no longer polymorphic.
  </ChangelogItem>

  <ChangelogItem type={'Removed'}>
    The `civilTitle` enum property has a reduced number of allowed values.
  </ChangelogItem>

  <ChangelogItem type={'Changed'}>
    The `nationalitiesCountryCodes` array property only accepts a single value as of now (for legacy compatibility).
  </ChangelogItem>
</Update>

<Update label="March 2025" description="v: 2024-11-01">
  <Frame>
    <img alt="New Release" src="https://mintcdn.com/lucca/6CPlsApetP0UYjIR/assets/images/new-release.svg?fit=max&auto=format&n=6CPlsApetP0UYjIR&q=85&s=f3385b603fb53497124efd04b207acf0" width="1501" height="509" data-path="assets/images/new-release.svg" />
  </Frame>

  ## Beta Release of Version 2024-11-01

  First release of the Lucca API.

  Please note the Lucca API is released in a beta state. As a result, you may encounter bugs and/or features not working as expected or simply missing.

  <Warning>While in beta, breaking changes may be introduced without releasing a new version.</Warning>

  <ChangelogItem type={'Added'} breaking={false}>
    Employees: `employee`, `employment`, `probationary-period`, `job-position`, `profession`, `job-qualification`, `occupation-category` and `employee-personal-record` objects and endpoints.

    Some endpoints may be read-only as of now.
  </ChangelogItem>

  <ChangelogItem type={'Added'} breaking={false}>
    Organization: `legal-entity`, `business-establishment`, `department` objects and endpoints (read-only).
  </ChangelogItem>

  ## First Draft of The Lucca API Documentation

  First release of the Lucca API documentation articles.

  <ChangelogItem type={'Added'} breaking={false}>
    General articles about the Lucca API features.
  </ChangelogItem>

  ## Maintaining the Legacy APIs Documentation

  The documentation of the Legacy APIs can still be browsed.

  <ChangelogItem type={'Changed'} breaking={false}>
    The API Reference for the Legacy API.
  </ChangelogItem>
</Update>