Versioning

Project Feed uses date-pinned API versions so clients can adopt changes deliberately.

Current Version

The REST API is served under /api/v1. Within that major version, Project Feed advertises a date-pinned contract with X-Project-Feed-Api-Version. The current default date version is 2026-05-26.

GET /api/v1/projects HTTP/1.1
Host: projectfeed.app
Authorization: Bearer pf_live_YOUR_API_KEY
X-Project-Feed-Api-Version: 2026-05-26

Response Headers

X-Project-Feed-Api-VersionThe date-pinned API contract applied to the response.

DeprecationPresent when an endpoint or version has entered deprecation.

SunsetThe earliest retirement date for a deprecated contract.

Compatibility Window

Breaking API changes require a new date version. Deprecated contracts receive at least 24 months of support before retirement. During a deprecation window, responses include Deprecation and Sunset headers so clients can schedule migrations.

Version Discovery

Call GET /version or GET /api/version to inspect the current API version metadata and supported date versions.