Versioning and deprecation

Legacy /api/v1/link/* paths and transition headers.

1 min read

The canonical paths are /api/v1/links/*. The legacy /api/v1/link/* path is routed to the same handler until the configured sunset date and carries these headers:

http

Deprecation: true
Sunset: <date>
Link: </api/v1/links>; rel="successor-version"

New integrations should use only /api/v1/links/*. The sunset date comes from the deployment configuration; rely on the Sunset header in the response.

Is something missing or wrong? Write to the support team; including the X-Request-Id value from the response speeds up the fix.