Aidelly developer policy

API versioning and deprecation

The Aidelly Public API uses URL versioning. The current stable base path is https://app.aidelly.ai/api/public/v1, and v1 is not deprecated.

What can change inside v1

Aidelly may add endpoints, optional fields, response headers, or enum values to v1. Breaking changes move to a new versioned base path unless a security or legal requirement makes that unsafe.

Deprecation notice

A scheduled retirement receives at least 90 days of notice. The affected response includes a standards-based Deprecation header using an RFC 9745 Structured Field Date, a Sunset header using an RFC 8594 HTTP-date, and a Link header to migration guidance. Security, abuse, or legal emergencies may require a shorter window.

How agents discover changes

  • Developer documentation and changelog
  • OpenAPI operation metadata
  • Deprecation response header using an RFC 9745 Structured Field Date
  • Sunset response header using an RFC 8594 HTTP-date
  • Link response header pointing to migration guidance