Catalog API v2 — Stable Release

Platform Engineering

The Catalog API v2 reaches stable status, bringing a cleaner resource model, cursor pagination, and a backwards-compatible migration path from v1.

Catalog API v2 — Stable Release

The Catalog API v2 has graduated from preview to stable.

What is New in v2

  • Cursor pagination replaces offset-based paging — results are stable under concurrent writes
  • Typed error envelope: every error now carries a code, message, and optional detail field
  • Resource versioning: each catalog entry exposes a resourceVersion field for optimistic-concurrency guards

Migration from v1

The v1 API is deprecated and will be removed in 2.6. Write paths require apiVersion: v2 on the request body; v1 payloads are rejected with HTTP 400 and a migration hint.