API versions
The Spectral API is versioned by date. Pin a version to keep behavior stable as the API evolves.
| Version | Status | Reference | Changelog |
|---|---|---|---|
| 2026-06-15 | Current | Reference | Changelog |
Pin a version with Spectral-Version
Every request resolves to a version. By default you get the version your API key was created against. To pin a single request to a specific version, send the Spectral-Version header:
curl https://spectral.principled.app/api/v1/me \
-H "Authorization: Bearer ak_your_key_here" \
-H "Spectral-Version: 2026-06-15"
A version is fixed per key: a new API version never silently changes the behavior of an existing key. Sending an unknown Spectral-Version returns 400 with the list of valid versions.