Canales y compatibilidad

Capacidad	REST v1	CLI	MCP de esta entrega
Identidad, objetos y campos	Sí	Sí	Sí
Lectura, historial y transiciones disponibles	Sí	Sí	Sí
Crear, modificar o borrar registros	Sí	Sí	No
Ejecutar acciones/transiciones	Sí	Sí	No
Archivos, analítica, bulk y eventos	Sí	Sí	No
Calendario y notificaciones propias	Sí	Sí	No
Retrieve y validate de metadata	Sí	Sí	Sí
Consultar despliegues de metadata	Sí	Sí	Sí
Deploy, cancel, quick deploy y rollback	Sí	Sí	No
Corridas y aprobaciones de agentes	Sí	Sí	No

La referencia OpenAPI es el inventario completo de operaciones REST, con scopes y riesgo. La presencia de un endpoint no implica que la conexión esté autorizada a usarlo. La IA interna puede incorporar capacidades adicionales que todavía no constituyen un contrato público.

Versiones y ambientes

La ruta /api/v1 identifica la versión mayor del contrato REST. El manifiesto del portal publica un hash del snapshot de OpenAPI y del catálogo MCP; esos hashes identifican exactamente la documentación distribuida.

Consultá /api/v1/capabilities y /api/v1/openapi.json en el ambiente de destino. El catálogo MCP efectivo se obtiene con tools/list. No deduzcas la compatibilidad por el nombre de un tenant ni supongas que desarrollo, UAT y producción sirven la misma release.

Qué no debe inferir un cliente

Los esquemas de respuestas tipadas se generan desde los controladores. Las partes dinámicas, como campos de registros, entradas de acciones custom o definiciones extensibles, permanecen abiertas intencionalmente. Un esquema abierto no autoriza nombres arbitrarios: se completa con el descubrimiento del recurso, sus permisos y las validaciones del servidor.

OpenAPI sirve para construir solicitudes y clientes; no sustituye las reglas de negocio. El servidor sigue siendo la autoridad sobre permisos, límites, dependencias y estado vigente.