> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cucu.bo/llms.txt
> Use this file to discover all available pages before exploring further.

# Versionado

> La API usa versionado en la URL. Cambios breaking se introducen en una nueva versión.

## Versión actual

La API usa versionado en la URL:

```
/api/v1/
```

Todos los endpoints actuales están bajo `/api/v1/`.

***

## Política de cambios

| Tipo de cambio                       | Qué hacemos                                          |
| ------------------------------------ | ---------------------------------------------------- |
| Nuevo endpoint                       | Se agrega bajo `/api/v1/` sin aviso previo requerido |
| Nuevo campo en response              | Se agrega bajo `/api/v1/` — backwards compatible     |
| Campo nuevo **requerido** en request | Se anuncia con anticipación, luego `/api/v2/`        |
| Cambio en comportamiento existente   | Se anuncia con anticipación, luego `/api/v2/`        |
| Eliminación de campo o endpoint      | Se depreca primero, luego `/api/v2/`                 |

<Info>
  Los cambios breaking se anuncian por email a todos los titulares de API Key con al menos 60 días de anticipación antes de introducir una nueva versión.
</Info>

***

## Múltiples versiones activas

Cuando exista `/api/v2/`, la versión `/api/v1/` permanecerá activa durante un período de transición mínimo de **6 meses** para permitir la migración sin interrupciones.