When backwards-incompatible changes are made to the API, we release a new, dated version. Learn more about API updates, view our API changelog.
By default, requests made with cURL use your Ophelos account's default API version unless you override it by setting the Ophelos-Version header.
Webhook events also use your account's API version by default.
You can upgrade your API version in the Ophelos Terminal.
curl https://api.ophelos.com/debts \
-H "Ophelos-Version: 2025-04-01"
Backwards-compatible changes
Ophelos considers the following changes to be backwards-compatible:
- Adding new API resources.
- Adding new optional request parameters to existing API methods.
- Adding new properties to existing API responses.
- Changing the order or properties in existing API responses.
- Changing the length or format or opaque strings, such as object IDs, error messages, and other human-readable strings.
- Adding new event types.
- Make sure that your webhook listener gracefully handles unfamiliar event types.