Developer console
Changelog
All sections
API lifecycle
Versions and change policy
The path major (/api/v1) changes only for breaking behavior. Contract additions remain backward compatible and appear here before rollout.
2026-07-09 · API v1
Decision delivery foundation
- Added trip-health, best-window, evaluate-rules, and material-change contracts.
- Added scoped credentials, monthly quotas, request IDs, usage logs, and fail-closed commercial quota enforcement.
- Added signed webhooks, delivery health, retries, redelivery, API/MCP status, and OpenAPI 3.1.
Compatibility promise
Within a major version, Perigee may add optional fields, endpoints, enum values where documented as extensible, headers, and webhook event types. Clients must ignore unknown response fields and avoid exhaustive handling of open enums.
Breaking changes receive a successor major version, migration guide, response-level Deprecation and Sunset notices where applicable, and at least 12 months of support after the successor reaches general availability. Security or provider-mandated emergency changes may move faster with an incident notice.
Webhook schemas are versioned by apiVersion. Existing event fields are not repurposed; new fields are additive. Retry and signature semantics are stable within v1.