API Versioning & Deprecation Policy
Stable lifecycle contracts and machine-readable signaling so autonomous AI agents and enterprise production pipelines never experience unexpected breaking changes.
1. URI Path Versioning
Predictable URL Namespace
All Erayaha REST endpoints are versioned explicitly in the URL path (e.g. https://erayaha.ai/api/v1/scan). Version 1.0.0 represents our active LTS interface and is guaranteed to receive continuous support and backward-compatible feature expansions through at least December 31, 2028.
2. Deprecation & Sunset Headers
IETF Standard Machine Signaling
When an endpoint or schema variant is slated for deprecation, Erayaha attaches standard HTTP response headers to inform agents in real time:
3. Model Context Protocol (MCP) Stability
Semantic Tool Consistency
MCP tool definitions (scanContractVulnerability, analyzeClausePlaybook, calculateRoiSavings, batchScanContracts) follow strict non-breaking evolution rules. New parameters are added as optional, and existing output schemas remain stable.
4. 12-Month Notice Guarantee
Enterprise SLA Commitment
We guarantee a minimum of 12 months advance notice before retiring any major API version, accompanied by automated migration tools, redline test suites, and sample conversion scripts.