API Versions
We maintain a stable API surface to ensure your integrations remain functional even as we evolve our underlying infrastructure.
The V1 API Registry
The current stable production version is V1. All endpoints are accessible via https://risu.in/api/v1/. We strictly follow semantic versioning for our API interface.
Non-breaking changes, such as new optional response fields or new documentation routes, are released directly to V1 without warning.
Version Pinning
For enterprise users, we support API version pinning. By including an 'X-Risu-Version' header, you can lock your requests to a specific minor release to avoid any unexpected behavior during platform updates.
Deprecation Strategy
When an endpoint is marked for deprecation, it will continue to function for a minimum of 6 months. During this period, responses will include a 'Warning' header with the planned sunset date.
Ready to integrate?
Start building with our free tier and follow our detailed API contract.