# Versionado

La API Auvo usa **versionado por URL**: v2 vive en `/v2`. Los cambios
compatibles (campos opcionales nuevos, nuevos endpoints) entran en v2; los
cambios incompatibles pasan a la próxima versión mayor.

## Política de deprecación

- Un endpoint o campo marcado como deprecado permanece **al menos 90 días**.
- Las deprecaciones aparecen:
  - En `x-deprecation-date` del spec.
  - En la respuesta, mediante el encabezado `Deprecation: @timestamp`.
  - En el [changelog](/changelog) semanal.
  - Por correo a los administradores de cuentas que usaron el endpoint en los últimos 30 días.


## Qué NO es un breaking change

- Nuevos campos opcionales en requests.
- Nuevos campos en responses.
- Nuevos endpoints / nuevos verbos.
- Nuevos códigos 2xx y 4xx con significado adicional.


## Qué SÍ es un breaking change

- Eliminar/renombrar campos o endpoints.
- Cambiar tipos/enums existentes.
- Agregar campos **obligatorios** en requests.
- Cambiar códigos HTTP en operaciones ya existentes.


## Canal de comunicación

Suscríbete a `changelog.rss` o sigue nuestro feed RSS/Atom. Quienes estén
suscritos a Webhooks con el evento `api.deprecated` también reciben aviso.