🎉 Visit Algorythmos →

Algorythmos uses semver-style versioning for REST endpoints. Breaking changes trigger a new major version that you opt into explicitly.

Default version

Requests without an explicit version header use the latest stable release.
When a new major version ships, we maintain the previous version for at least 12 months.

Requesting a specific version

GET /processors/invoice-extractor/runs/run_123 HTTP/1.1
Host: api.algorythmos.fr
x-api-key: $ALG_KEY
x-api-version: 2025-09-01

Use the x-api-version header to pin to a release date. We recommend locking on deploy and bumping only after validation.

Change notifications

Upcoming breaking changes are announced in /changelog.
Subscribe to workspace email updates under https://app.algorythmos.fr/settings/notifications.

If you need longer support windows, contact support@algorythmos.fr so we can align on an upgrade plan.