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.