Skip to content

Documentation

Changelog

Dated versions, pinned with the Easarc-Version header. We do not change behaviour under a version you have pinned.

Versioning policy

Pin a version with the Easarc-Version header on every request. If you do not send one, we use the version that was current when your account was created — never the newest, so a new release cannot break you overnight.

Within a version, we only make additive changes: new endpoints, new optional parameters, new fields on a response, new enum values. Anything that could break an integration goes into a new dated version. When we deprecate a version we give at least twelve months’ notice, and we email every account still using it.

Adding an enum value is additive on our side but can surprise a strict client, so handle unknown enum values gracefully rather than throwing.

Releases

2026-08-01

1 Aug 2026Breaking changes

Current version. Vision review endpoints and the combined invoice call.

  • BreakingPOST /v1/orders/{id}/invoice now derives the CGST/SGST versus IGST split from place_of_supply rather than from the buyer’s billing state. Invoices that previously registered with the wrong split will now be corrected automatically — check your reconciliation before upgrading.
  • BreakingUnknown fields in a request body are rejected with unknown_field instead of being ignored. This catches typos that used to fail silently.
  • AddedPOST /v1/defects/{id}/review for confirming, reclassifying or dismissing a detection, and feeding the next training run.
  • Addedgenerate_eway_bill on the invoice call, so Part-A can be registered in the same request as the IRN.
  • Addedref: prefix on order paths, so you can address an order by your own reference rather than storing ours.
  • ChangedValidation errors now return every failing field in details rather than stopping at the first one.

2026-07-15

15 Jul 2026

Webhook replay, incremental sync and inspection sessions.

  • AddedGET /v1/events and POST /v1/events/{id}/replay, with 30 days of event retention, for recovering from an outage on your side.
  • Addedupdated_since on all list endpoints, for incremental sync without walking everything.
  • AddedGET /v1/inspection-sessions, grouping defect events by the run of a work order on a machine.
  • Fixedratelimit-reset was reporting the window length rather than the seconds remaining. It now reports the remaining seconds, as documented.
  • FixedCursor pagination could skip an item when a new order was created mid-walk. Cursors are now stable against inserts.

2026-07-04

4 Jul 2026

First public version, released the day the company was incorporated.

  • AddedOrders, line items and production stages — /v1/orders and /v1/orders/{id}/stages.
  • AddedGST e-invoice registration and e-way bill Part-A and Part-B under /v1/invoices.
  • AddedCameras and defect events — /v1/cameras and /v1/defects.
  • AddedWebhooks with HMAC-SHA256 signatures and 24 hours of retries.
  • AddedOfficial JavaScript and Python SDKs, and the Easarc CLI for Deploy.

Upgrading

Change the header, run against sandbox first, and read the breaking entries for every version between where you are and where you are going. There is no automatic migration and no partial upgrade — a request is served entirely under one version.