Versioning

The API version is part of the URL path:

http

https://api.duck-hub.com/v1

There is no /api prefix — the version segment comes right after the host. All endpoints documented here live under /v1.

Compatibility policy#

Within v1, we make only additive changes:

new endpoints,
new optional request fields,
new fields in responses.

Changes that would break existing integrations — removing or renaming fields, changing types or semantics, tightening validation — ship as a new version prefix (/v2), with v1 kept running during a migration window.

Build forward-compatible clients

Ignore response fields you don't recognise instead of failing on them — new fields may appear in v1 responses at any time. (Request bodies are strict the other way around: fields that are not part of the documented schema are rejected with a validation error.)