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

# Novedades

> Qué ha cambiado en la API de Brelio y el servidor MCP, y qué se sabe que todavía no funciona.

`/v1` solo crece añadiendo. Un cambio incompatible sale como una versión nueva de la operación, y la antigua anuncia su final con las cabeceras `Deprecation` y `Sunset`.

**Noviembre de 2026**

v1, acceso anticipado

Primera versión de la API de Brelio y del servidor MCP, abierta a clínicas en acceso anticipado.

**API REST** en `https://api.brelio.app/v1`:

* Equipo: listar centros, profesionales y servicios.
* Agenda: leer la agenda, buscar huecos libres, y leer, reservar, reprogramar y cancelar citas sueltas.
* Pacientes: buscar, leer, crear, actualizar y archivar datos administrativos.
* Integraciones: listar y revocar claves de API de la organización y apps de partners; tus propias claves y conexiones; webhooks (crear, probar, reenviar, rotar el secreto, eliminar); la política de datos de la clínica y sus decisiones.
* Concurrencia optimista con `expectedVersion`, `Idempotency-Key` en cada escritura, paginación por cursor, errores RFC 9457 con códigos estables, cabeceras IETF `RateLimit`.

**Servidor MCP** en `https://api.brelio.app/mcp`: OAuth con tu cuenta de Brelio, herramientas de lectura generadas desde el mismo catálogo, aceptación de datos de pacientes con elicitation por URL.

**Áreas de datos:** la clínica decide qué datos pueden usar las integraciones; los datos de pacientes están desactivados por defecto y necesitan la aceptación de la clínica y de cada credencial.

**Webhooks:** firmas Standard Webhooks, reintentos durante 3 días, rotación del secreto con 24 horas de solapamiento. Tipos de evento: `webhookEndpoint.tested`.

## Limitaciones conocidas

A noviembre de 2026:

* **Las credenciales personales no pueden usar operaciones por centro.** Las conexiones MCP y las claves personales reciben `403 OPERATION_FORBIDDEN` en la agenda, los huecos libres, las citas y los pacientes, y esas herramientas no aparecen por MCP. Las claves de la organización y las apps de partners no están afectadas.
* **MCP es solo de lectura.** Las herramientas de escritura (reservar, reprogramar, cancelar, pacientes, webhooks) aparecen en [Herramientas MCP](https://docs.brelio.com/es/mcp/tools.md) pero todavía no se sirven; usa REST.
* **Las áreas de pacientes no se pueden activar en producción** hasta que se publiquen las condiciones de datos de pacientes revisadas (`409 PATIENT_DATA_TERMS_PENDING`).
* **Los webhooks solo entregan el evento de prueba.** Los eventos de citas y pacientes vienen después.
* **Las citas recurrentes** no se pueden reprogramar ni cancelar por la API.
* **No hay modo de pruebas.** Todavía no hay credenciales ni clínicas de prueba; prueba la API en tu propia clínica empezando por operaciones de lectura.
* **Historia clínica, notas y facturación** todavía no tienen operaciones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.