API Documentation Changelog

This page tracks changes to the Altana API and its documentation, in reverse chronological order, grouped by month and then by area. Read the current API reference, and create API keys and service accounts, from the /api/nexus/api-docs/ route in your environment.

August 2026

Self-serve service-account keys for administrators

Administrators can now create, rotate, and revoke API keys for service accounts in their own environment, without help from Altana.

Choose the roles an API key carries

When you create an API key, you can select which of the service account's roles the key carries. All roles are selected by default; narrow the selection to issue a more limited key.

API key expiration reminders

Email reminders now go out as an API key approaches its expiration, so you can rotate it before it lapses. By default reminders go to the key's creator, but you can instead send them to an alternative email address or to a list of up to 10 addresses — for example, a shared team inbox or on-call rotation.

June 2026

Subscribe to catalog changes

You can now subscribe a webhook to a catalog and receive its product changes — created, updated, and archived — as batched, signed events, so your systems stay current without polling. See Catalog Subscriptions.
Delivery is at-least-once with a stable event_id for deduplication, retries on a widening schedule, and automatic pausing of an endpoint that stays unreachable.

API documentation served from your environment

API documentation moved to the /api/nexus/api-docs/ route in your environment, with API Reference, API Keys, and Service Accounts in one place.
The API reference is now generated from the API itself, so it always matches the version running in your environment.

This page is updated as the API and its documentation evolve.