Aegis

Aegis Workspace

Developer

Checking session...
AegisAegis Developer Portal

Developer Search

Press ⌘K or Ctrl+K to jump through guides and API endpoint docs.

Versioning

Versioning and Deprecation Policy

API compatibility follows clear release policy. Deprecations are announced before removal and include migration guidance.

Compatibility Contract

  • API semantics remain stable within a major version.
  • Field additions are preferred over removals.
  • Breaking changes require versioned replacement endpoints.
  • Reference docs and examples are updated on each release.

Deprecation Stages

  1. Announce deprecation in changelog and migration docs.
  2. Mark in docs explorer and SDK notes.
  3. Provide minimum 2 release windows before removal.
  4. Remove only after usage telemetry confirms migration.

Release Expectations

  • Every release note includes impacted endpoints and migration action.
  • Security-sensitive changes include incident-safe rollout guidance.
  • SDK release tags map to compatible API contract snapshots.
Open Changelog