# Niuro Public API Versioning, Deprecation, and Sunset Policy

Canonical policy: <https://niuro.io/docs/api-lifecycle.md>

## Version selection

Niuro's public API uses a major version in the URL path. The current jobs
contract is `GET /api/v1/jobs/`. Additive fields can appear within v1, so
integrations must ignore unknown properties. A breaking contract change uses a
new major path such as `/api/v2/`.

## Deprecation notice

Before deprecating a version, Niuro updates this policy and the developer portal,
then emits the standardized `Deprecation` response header and a `Link` with
`rel="deprecation"` pointing to the applicable migration guidance.

## Sunset notice

Niuro provides at least 90 days between announcing a deprecation and a published
`Sunset` date. When a removal date is known, responses include the standardized
`Sunset` header and the migration documentation states the replacement path.

## Current status

Version 1 is current and is not deprecated. It therefore emits neither a
`Deprecation` nor a `Sunset` header today.