Versioning

The API is versioned in the path: /v1/. Everything under /v1 is stable.

What's stable

• The response envelope (items, status, sources, …).
• Existing actor names and their input fields.
• Auth (X-API-Key) and error shapes.

What can change without a version bump

• New actors, new optional fields, and new categories.
• Additive changes never break existing calls.

Breaking changes

Anything that could break an existing integration ships under a new path (e.g. /v2/). /v1 keeps working. Breaking changes are announced in the changelog first.

Pin to /v1 and read items — you'll be forward-compatible.