Saltar al contenido principal
/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.
​
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 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.