API Versioning & Deprecation Policy
Stable lifecycle contracts and machine-readable signaling so autonomous AI agents and enterprise production pipelines never experience unexpected breaking changes.
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.
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:
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.
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.