Agento AI API Versioning & Deprecation Policy
This policy outlines how WebCore Studio manages API changes, signals deprecation, and ensures autonomous AI agents and enterprise integrations experience zero unexpected downtime.
1. API Versioning Conventions
Agento AI supports dual versioning mechanisms:
- URL Path Versioning: All endpoints are accessible via versioned paths such as
/api/v1/...alongside canonical aliases. - Header Versioning: Every response includes the
X-API-Version: 2026-09-01header indicating the exact active contract.
2. 180-Day Sunset Guarantee
We guarantee a minimum of 180 days advance notice before removing or modifying any endpoint in a backwards-incompatible manner.
Announced via email, release notes, and OpenAPI spec.
HTTP Deprecation and Sunset headers returned on all calls.
Endpoint gracefully transitions to HTTP 410 Gone.
3. Machine-Readable Deprecation Headers
Deprecated operations return standard RFC 8594 headers to allow autonomous agents to self-adjust:
Deprecation: @1756684800
Sunset: Wed, 01 Sep 2027 00:00:00 GMT
Link: <https://orderagentapp.webcorestudio.dev/deprecation>; rel="deprecation"
Current API Lifecycle Status: Active (v1)
All endpoints documented in our OpenAPI 3.1 Specification are fully active and supported under SLA.