API de Sixto: las mismas acciones y permisos que usa tu equipo
La API de Sixto expone las mismas acciones que usa la app: tareas, registros, reportes, mensajes y más, con claves que solo tienen los alcances que les das. Cada llamada queda en el registro de actividad de la clave. Una clave puede consultar qué puede hacer y quién es. Las acciones sensibles esperan la confirmación de una persona.
Disponible. Una API REST versionada con llaves con permisos cubre reservas, huéspedes, tareas, finanzas, registro, cerraduras, canales y más.
Tus herramientas, acceso limitado
Las claves solo reciben los permisos que elijas
Qué hace
Qué se comparte y qué permanece igual
Las flechas indican la dirección de los datos respecto a Sixto.
Cobertura amplia
Tareas, reservas, huéspedes, reseñas, mensajes, registro, cumplimiento, cerraduras, canales, facturas electrónicas, banco y libro contable, referencias de mercado, búsqueda y ajustes.
Llaves con permisos de un solo catálogo
Las llaves usan el mismo catálogo de permisos que las personas. Para cambiar permisos, un Propietario crea una llave de reemplazo y revoca la anterior. La revocación se aplica a la siguiente llamada.
Se describe sola
Pregúntale a la API quién eres y qué puedes hacer (whoami y capabilities), incluidos los permisos que requiere cada ruta.
Reintentos seguros y registro de actividad
Cada escritura documenta su identidad de reintento, como external_id o el encabezado Idempotency-Key, y responde 409 si se repite la misma identidad con otro contenido. Cada solicitud tiene un ID y aparece en el registro de actividad.
Límites justos
Cada llave tiene su propio cupo, 600 solicitudes por minuto por defecto, así que una llave ocupada nunca frena a otra. GET /api/v1/capabilities informa el valor actual.
¿Prefieres una app de IA? Usa MCP
Además de la API REST, Sixto tiene un servidor MCP para apps de IA, con inicio de sesión OAuth y apagado hasta que un Propietario o Gerente lo active, y un MCP de documentación público y de solo lectura.
- Dirección del servidor
https://sixto.app/mcp- MCP de documentación
https://sixto.app/mcp/docsPúblico y de solo lectura. Busca en la documentación de Sixto y nunca ve los datos de tu organización.
Cómo funciona
- 01
Un Propietario crea una llave en Configuración y marca los permisos que necesita. La llave se muestra una sola vez.
- 02
Envíala como token Bearer. Llama a whoami y capabilities para ver qué puede hacer la llave.
- 03
Lee o escribe mediante los endpoints. Las escrituras pasan por las mismas verificaciones que la app.
- 04
Mira las llamadas en la vista de actividad de la API y revoca una llave cuando quieras.
Qué se sincroniza
Preguntas frecuentes
¿Hay una guía para desarrolladores?
Sí. La referencia OpenAPI 3.1 está en /api/v1/openapi.json y la guía para clientes en /api/v1/guide.json. Cada operación indica x-contract-status: complete significa un contrato revisado, unsupported significa que la ruta sigue disponible pero queda fuera de la superficie soportada para clientes. Un servidor de documentación de solo lectura está en /mcp/docs.
¿En nombre de quién actúa una llave?
Una llave actúa por la organización, dentro de sus propios permisos. No tiene una lista de propiedades propia ni hereda los límites de propiedad de quien la creó. Cuando Sixto reenvía la solicitud de una persona con una delegación Sixto-On-Behalf-Of, también se aplican los límites actuales de propiedad y permisos de esa persona.
¿Cómo cambio los permisos de una llave?
Crea una llave de reemplazo con los permisos que quieres, cambia tu herramienta a ella y luego revoca la llave anterior. Las llaves existentes no se pueden editar. Una llave revocada se rechaza en su siguiente llamada.
¿Qué significan 422 y 429?
422 significa que la validación falló: lee el objeto errors por campo, corrige los datos y envía de nuevo. 429 significa que la llave llegó a su límite: espera los segundos del encabezado Retry-After y reintenta con espera progresiva. Guarda el X-Request-Id para encontrar la llamada en el registro de actividad.
¿Una llave puede abrir una puerta?
No. La apertura remota nunca está disponible por la API.
¿La API tiene versiones?
Sí, vive bajo /api/v1.

