API versions
The Spectral API is versioned by date. Pin a version to keep behavior stable as the API evolves.
| Version | Status | Reference | Changelog | Schema |
|---|---|---|---|---|
| 2026-09-07 | Current | Reference | Changelog | Schema |
| 2026-08-04 | Supported | Reference | Changelog | Schema |
| 2026-06-15 | Supported | Reference | Changelog | Schema |
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.
note
One documented exception. The three input bounds introduced in 2026-09-07 are validated on every pin, not only from that revision onward. They reject only values that could never produce a working result — see that changelog entry for the detail.