Copy page

Changelogs

Aerion API Release Notes

Release notes for the Aerion API encompass functional adjustments to API behavior, new additions, and documentation adjustments. Features mentioned in this changelog are not necessarily available via the web UI, or they may be restricted to the Early Access preview experience.

v2.2.3 - 2026-09-10

• Fixes an issue where users with the canArchiveOwnProjects permission could sometimes not actually archive their own projects.
• Updated a variety of API error responses to more specifically explain issues with omitted or malformed parameters.
• Added more detailed enum info to a number of properties in the API documentation.
• Officially retired a couple of deprecated billing and budgeting enum modes that were not used in the UI or by any legacy projects.
• Added support for several upcoming features; additional undocumented fields may be present on some model responses. We look forward to sharing more at a later date.

v2.2.2 - 2026-08-26

• Optimizations to socket performance.

v2.2.1 - 2026-08-18

• Adds backend support for capping total effort to the budget amount via the capEffortAtBudget setting, and adds analytics fields to support the capped amounts. Support for this feature in the browser UI will follow in a later front-end early access release.

v2.2.0 - 2026-08-12

This update modernizes a number of older analytics and controlling feeds. Adjustments include correcting long-standing corner-cases, optimizing for performance, and retiring older features.

Corrections and Fixes

• Overtime - /v1/overtimereductions/calc - Fixes an issue where overlapping non-holiday, non-overtime reduction, full-day absences stacked on the same day would credit overtime back to the overtime balance. This constellation generally should not occur in practice, but could appear if a sick day is taken during a vacation, via an oversight, or via dirty data from a 3rd party provider. If Overtime budgets were previously manually edited to counteract the old behavior, these will need to be removed.
• Project Analytics - /v1/analytics/projects - Substantial changes to the underlying cost/profitability calculation. Previously, user costs were averaged over a monthly period. Cost calculations have been revised to be day-accurate. For example, if a user previously had hourly costs of 50€/hour, and was changed to 60€/hour mid-month, this was averaged to 55€/hour for the entire month, meaning every time entry recorded by the user during that month would be assigned a cost of 55€ per hour. Now, costs use the precise daily hourly costs. The net effect is that projects with heavy tracking on the beginning or end of the month will see their costs change. The overall effect averaged across all projects is minor and evens out.
• User Workload - /v1/users/{user}/workload/{year}/monthly - Fixes an issue where the billableHours value would be doubled on days with more than one absence. This could commonly happen with two half-day absences.
• Staff Analytics (Legacy) - /v1/analytics/staff - Fixes an issue where per-project tracked hours were in most cases wildly incorrect; these values were not surfaced in the UI and were incorrect enough that any consumer likely would have noticed. This particular API has been superseded by the v1/analytics/users feed in most browser UI views.
• Time Entry Analytics & Staff Analytics (Legacy) - v1/analytics/time-entries - Fixes an issue where the Out-of-Budget amounts in both of these APIs improperly included amounts from time entries that were formerly out-of-budget, but returned to being in budget after the budget of their corresponding project was increased so that all time entries were in budget.

If you would like more information about any of the above changes, or would like a before/after difference of any specific value or feed, please contact us via our support channels.

Adjustments

• Project and Planner Analytics - v1/analytics/projects and v1/planner/analytics/lightweight - Planned hours and planned amounts now include contributions from archived projects and users, matching the recently adjusted display and capacity logic on the front-end.
• Planned Hours Export - now includes planned hours of archived users

Performance Improvements

• The following API areas will see in some cases substantial performance improvements: Overtime, User Analytics, Client Analytics, Super Project Analytics, User Workload, Planner Exports, Vacation Budgets, Time Entry Analytics, Time Entry Exports, large or multi-paginated requests, requests with complex filters, and Reference searching.
• We continue to monitor API response times and have targeted further improvements centered around Invoicing and Dashboard loading performance for a future update. If you are experiencing particularly poor loading performance in the UI or slow response times via API operations, please reach out to our support channels so we can evaluate and prioritize your use cases.

v2.1.7 - 2026-07-30

• Time entries now expose a settable, filterable importId field linking an entry to its source record from an external import.

v2.1.6 - 2026-07-27

• Adds the option to remove upcoming planner assignments when completing or archiving a project or client, or when unassigning a user from a project.
• Archiving a client or super project will no longer mark child projects as completed; pass complete=true to also complete them.
• Reactivating a project now also reactivates its parent project and client.

v2.1.5 - 2026-07-24

• Fixes an issue where overtime for users with flexible working time could accumulate/decrease when worktime was tracked by these users. In practice, this was primarily an issue for users that were subsequently changed to use fixed hours.

v2.1.4 - 2026-07-23

• Fixes a field permission issue that led to account-specific overrides not being readable by all users. In practice, this was resulting in the max number of Project Leads property not being available to PMs, and the restriction not being enforced.
• Refreshed public holiday data to the latest available, adding support for several more countries, including India, Kazakhstan, Sri Lanka, Pakistan, Saudi Arabia, and Thailand.

v2.1.3 - 2026-07-21

• Fixes a server error when submitting time entries for periods where the user does not have an active employment entry.
• Deleting a super project now correctly checks the entire cascade chain of its sub-projects, preventing deletion of the super project if any of its sub-projects cannot be deleted, and cleaning up after the sub-projects that are successfully deleted.

v2.1.2 - 2026-07-17

• Re-adds the isTeamLead property to Team Assignments - it grants no additional permissions, but can be used for display, filtering, and exporting.
• Adjusted the HTTP status code of errors returned from the save-worktime feed; error body remains the same.

v2.1.1 - 2026-07-13

• Relaxed time entry creation rules for projects on days where the user has already submitted time. Time entry creation is now allowed regardless of other entries' submission or approval status, up until the project day for the respective project is locked (or time-based locking is in place).
• Skill Management is now documented in the API reference: skills, skill sets, skill categories, and user skill assignments.

v2.1.0 - 2026-06-18

• Overhauled error response body - responses now carry stable codes plus localized title and description payloads. Consumers can switch on the error code and surface the localized message directly. This is a backwards-compatible change; existing error strings remain at their old location in the response payload and are supplemented with additional information.
• Fixes an issue that prevented the desktop client startup feed from loading when a task assignment existed for a deleted task

v2.0.2 - 2026-05-29

• Fixes a 504 that should have been a 400 when posting PlannerAssignments with an invalid post body

v2.0.1 - 2026-05-18

• New fields added to invoices (and planned invoices) to support internal/external designation and effective date.

v2.0.0 - 2026-05-09

Despite the major version bump, this is a non-breaking, backwards-compatible change; URLs and paths remain on the /v1/ namespace.

• Overhauled OpenAPI spec from the ground up, includes full/fixed schemas, model attribute descriptions, analytics-feed documentation, sorting hints, usage notes
• All routes in OpenAPI spec switched to kebab-case names (legacy URLs are aliased and include a deprecation header)
• Fixed a race condition that could create duplicate work time entries under concurrent writes.

v1.23.12 - 2026-05-02

• The default Project Manager role for new accounts now grants Planner View permission by default.

v1.23.11 - 2026-04-23

• New skill-assignment permissions added to Role, for more fine-grained access

v1.23.10 - 2026-02-18

• Adds deal probability and deal amount fields to Projects, and introduces Deal project state
• Fixes an issue in the SevDesk integration when importing multiple projects with the same name

v1.23.9 - 2026-02-13

• Improves performance of locking and unlocking project weeks, especially when many time entries are included.
• Improves load time of overtime-related items on the individual User Analytics page and on the User Edit page.
• Fixes an issue on Time Entry Analytics where filters for either References or Super Projects were not accounted for when performing bulk lock/unlock operations via the Lock icon in the table header.

v1.23.8 - 2026-01-23

• Fixes an issue where not-yet-added-to-an-invoice recurring expenses would count as effort in some project analytics displays.
• Fixes an issue where the "Total" label at the end of PDF Time Entry exports could overlap totals values depending on the order of columns.
• Setup for HRIS Worktime Sync.
• Adds projectLead property to UserAssignment.
• Adds canArchiveOwnProjects to Role.

v1.23.7 - 2025-12-03

• Fix time entry resubmit link in emails.