Cheat Sheet logoCheat Sheet Today
REST API Authentication, Authorization, and Versioning/Date-based compatibility header

Pin behavior by release date.

Back to sheetBrowse commands
Sign in to save
Section: Versioning strategies

Date-based compatibility header

http
http
API-Version: 2026-03-01
Explanation

Some APIs version behavior by date rather than integer versions, especially when changes are incremental.

View in sheet →

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Compare commandsView fixes

Related commands

Same sheet · prioritizing Versioning strategies
Path-based versioning
Explicit major version in the URL.
OpenIn sheethttpsame section
Media type versioning
Negotiate version with the Accept header.
OpenIn sheethttpsame section
Signal deprecations clearly
Warn clients before removing behavior.
OpenIn sheethttpsame section
API key header
Send a static API key in a header.
OpenIn sheethttp2 tag match
Bearer token header
Send an OAuth or JWT access token.
OpenIn sheethttp1 tag match
Do not put tokens in the URL
Keep credentials out of path and query strings.
OpenIn sheettext1 tag match