API documentation
Versioning
The Demarky API uses a single active version with forward-compatibility headers.
Current version
The current API version is v1.
Version header
Every response includes the X-API-Version header indicating the version used to serve the request:
X-API-Version: v1Deprecation headers
When an endpoint or version is deprecated, the response includes:
| Header | Description |
|---|---|
Deprecation | Indicates the endpoint is deprecated |
Sunset | RFC 3339 timestamp when the endpoint will be removed |
Link | URL to migration guidance or the new endpoint |
URL structure
The API version is embedded in the URL path:
https://api.demarky.ai/v1/{resource}All current endpoints use /v1/ as the version prefix.