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

# Changelog

> API version history.

<Update label="v1.0.1" description="Plan listing pagination, running-endpoint response, and payload warnings" date="2026-09-16">
  * `GET /plans` (light representation) is now always paginated — previously, no paging was applied unless `page` or `itemsPerPage` was explicitly set.
  * `PUT /plans/{planId}/running` now returns an `EnvelopedPlanReference` body instead of an empty response.
  * The light plan representation gains the same metadata fields as the full `Plan` object: `state`, `nbResources`, `nbOrders`, `createdAt`, `createdBy`, `updatedAt`, `updatedBy`, `archivedAt`.
  * Several plan and paging fields that were `nullable` now use field absence instead — check for the field's presence rather than for a `null` value.
  * New `Warning` concept: non-blocking amendments applied to an accepted payload (traffic turned off, crow-fly forced, `maxOptimizationDuration` clamped, and so on) are now surfaced on five response envelopes instead of silently applied.
</Update>

<Update label="v1.0.0" description="Initial release" date="2026-08-07">
  First public release of the Kardinal Route Optimization API.
</Update>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.