Media type versioning

http

Accept: application/vnd.example.v2+json

Explanation

This keeps URLs stable but can make testing and documentation slightly more complex.

Learn the surrounding workflow

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

Same sheet · prioritizing Versioning strategies

Explicit major version in the URL.

Open In sheethttpsame section

Pin behavior by release date.

Open In sheethttpsame section

Warn clients before removing behavior.

Open In sheethttpsame section

Send an OAuth or JWT access token.

Open In sheethttp1 tag match

Send a static API key in a header.

Open In sheethttp1 tag match

Keep credentials out of path and query strings.

Open In sheettext1 tag match