Todos los endpoints de esta página, salvo /auth/registro y /auth/login, requieren la cabecera Authorization: Bearer <token> (ver Autenticación) y actúan siempre sobre los datos del usuario dueño del token — nunca hace falta (ni es posible) pasar un usuario_id a mano. Las peticiones con cuerpo van en JSON (Content-Type: application/json); la respuesta siempre es JSON, con el sobre {"ok", "data"|"error"} descrito en Primera llamada a la API. Para el detalle de los campos de cada objeto (Nota, Tarea, Categoria...) ver Modelos de datos.
¿Vas a importar esta API en Postman, Insomnia, o generar un cliente automáticamente? GET /api/v1/openapi.json devuelve el documento OpenAPI 3.0 completo de todos estos endpoints — generado por introspección del propio código en cada petición (no un archivo aparte que se pueda desincronizar), sin necesitar token: es documentación pública. Las tablas de esta página son la referencia legible; ese JSON es la máquina-legible.
Documento OpenAPI 3.0 completo (cuerpos, parámetros, respuestas, códigos de error y ejemplos de cada operación), generado a partir del código. Sin token.
Manejo de errores
El sobre de error es siempre el mismo, en cualquier endpoint de esta API — incluidos los errores que genera Flask antes de llegar a la vista (404 de ruta inexistente, 405 de método no permitido): {"ok": false, "error": "mensaje legible", "codigo": "no_encontrado"}, nunca una página HTML. Programa contra codigo (estable), no contra el texto, que puede cambiar o traducirse. Códigos: peticion_invalida, token_invalido, token_solo_lectura, token_caducado, token_area_no_permitida, referencia_duplicada, referencia_invalida, valor_invalido, url_invalida, prohibido, no_encontrado, metodo_no_permitido, conflicto, idempotencia_conflicto, idempotencia_en_curso, limite_excedido y error_interno. Algunos errores de validación añaden campo.
El contrato OpenAPI
/api/v1/openapi.json describe todas las operaciones: cuerpo de la petición (JSON o multipart, con sus campos obligatorios), parámetros de consulta, cabeceras, cada código de respuesta con su esquema, los errores con su codigo, el área de token que exige cada ruta (x-area) y ejemplos de las operaciones principales. Se genera del propio código de la API (las columnas de las tablas dan los esquemas de las entidades), así que no puede quedar desactualizado. Impórtalo en Postman o Insomnia, o genera un cliente con openapi-generator / openapi-python-client / openapi-typescript.
Garantías de compatibilidad. Una batería de pruebas comprueba en cada cambio que el documento es válido, que lo que devuelve la API cumple su esquema y que no desaparece nada ya publicado: ni una ruta, ni un campo del cuerpo, ni un parámetro, ni un código de éxito, ni se vuelve obligatorio un campo que antes no lo era. Lo que se añade es siempre opcional.
Particularidad conocida:modelos_fiscales de un cliente fiscal llega como texto JSON ("[\"303\"]") en los listados y las escrituras, y como lista solo en GET /fiscal/clientes/{id}. Al enviarlo, siempre es una lista. El contrato lo documenta así tal cual.
Uso desde integraciones externas
Mecanismo
Cómo funciona
Versión
Cada respuesta lleva X-API-Version (1.x). El número menor sube con cada ampliación compatible; el mayor solo si algo se rompe. Los campos nuevos siempre son opcionales.
Límite
Por usuario (todos sus tokens suman): 600 peticiones/minuto, de ellas 200 escrituras (POST/PUT/PATCH/DELETE) y 20 operaciones pesadas (llamadas a la IA, exportaciones, importaciones, sincronizar un buzón, enviar correo). Cada respuesta lleva X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (segundos) del cupo más ajustado, y X-RateLimit-Scope (total, escritura o pesada). Al pasarte: 429 con Retry-After y el cupo en cupo. Una petición rechazada no gasta cupo.
IP permitidas
Al crear un token puedes indicar ips_permitidas (IP o redes CIDR, hasta 20). Desde otra dirección responde 403 con codigo: ip_no_permitida. Un token con IPs no sirve por MCP (allí no se conoce la dirección del cliente).
CORS (navegador)
Por defecto la API no permite llamadas desde páginas web. Con origenes_cors (orígenes exactos como https://panel.ejemplo.com, hasta 10, sin comodines) el token puede usarse desde esas páginas: la respuesta devuelve Access-Control-Allow-Origin con ese origen. El preflight (OPTIONS) solo se concede a orígenes que algún token vivo admite. Evita poner un token en el código de una web pública: úsalo desde un servidor siempre que puedas.
Verificación en dos pasos
Cada persona puede activarla en la web (Ajustes → Contraseña y email: app de autenticación y 12 códigos de recuperación de un solo uso). Entonces POST /auth/login con email y contraseña responde 401 con codigo: requiere_2fa; hay que repetir la llamada añadiendo codigo_2fa (6 dígitos de la app o un código de recuperación). Con un código incorrecto: 401 credenciales_o_codigo_incorrectos. Las cuentas sin 2FA no cambian. Los tokens de API ya emitidos siguen valiendo hasta que caduquen o se revoquen.
Estado del servicio
GET /api/v1/health (sin token) devuelve 200 con {"estado": "ok"} si el servicio atiende y la base de datos responde, y 503 si no. Pensado para Uptime Kuma o un balanceador.
Idempotencia
En cualquier POST añade Idempotency-Key: <cadena única>: si reintentas la misma petición (corte de red) devuelve la respuesta original con Idempotent-Replay: true en vez de crear un duplicado. La misma clave con otro cuerpo da 422. Vale 24 h; los errores 5xx no se guardan.
Caché
Las lecturas GET llevan ETag; reenvíalo en If-None-Match y recibirás 304 sin cuerpo si no ha cambiado.
Campos
?campos=id,asunto devuelve solo esos campos, en objetos y listas.
Trazabilidad
Cada respuesta lleva X-Request-Id (y los errores, request_id). Puedes enviar el tuyo en esa cabecera (8-64 caracteres: letras, números, ._-) para correlacionar; al pedir soporte, indica ese id.
Referencias externas
Notas, tareas de lista y clientes fiscales admiten referencia_externa (hasta 120 caracteres, única por usuario o despacho). Filtra con ?referencia_externa=; GET/PUT /notas|tareas-outlook|fiscal/clientes/por-referencia/{ref} hace upsert: crea (201) o actualiza (200, cabecera X-Guilda-Upsert) sin que guardes nuestros ids. Duplicada: 409 referencia_duplicada.
Paginación
limit/offset y total en X-Total-Count.
Sincronización
GET /sync da un cursor; después GET /sync?cursor=N devuelve solo lo que cambió (cambios y eliminados de notas, tareas, tareas de lista y proyectos). Ver «Proyectos, checklist, asignación y más».
HTTP
Significado en esta API
400
Datos de entrada inválidos: campo obligatorio ausente, formato incorrecto, valor fuera de rango.
401
Token ausente, revocado o incorrecto (ver Autenticación).
404
El recurso no existe, o existe pero pertenece a otro usuario — nunca se distingue entre ambos casos, para no filtrar si un id ajeno existe.
405
Método HTTP no soportado para esa ruta.
409
Conflicto — por ejemplo, /auth/registro con un email ya registrado.
429
Límite de peticiones superado (solo aplica a /auth/registro y /auth/login, ver abajo).
El límite de 10 peticiones/minuto por IP solo se aplica a /auth/registro y /auth/login (protección de fuerza bruta) — el resto de la API no tiene un límite de peticiones propio a nivel de aplicación. Si expones tu instancia a un volumen alto de peticiones automatizadas, añade tu propio límite en Caddy o en el proxy inverso que tengas delante.
Listados.GET /notas (fijadas primero; proyecto_id, q) y GET /tareas (tareas con duración; desde, hasta, proyecto_id) tienen listado propio. GET /historial sigue siendo el registro cronológico combinado y GET /dashboard el resumen del día. Todos los listados admiten limit/offset y devuelven el total en la cabecera X-Total-Count. Más abajo, «Proyectos, checklist, asignación y más».
Auth
Método
Ruta
Descripción
POST
/auth/registro
Crea una cuenta nueva y devuelve un token.
POST
/auth/login
Inicia sesión y devuelve un token nuevo.
POST
/auth/logout
Revoca el token de la propia petición.
GET
/auth/me
Datos de la cuenta autenticada.
Proyectos (categorías)
Método
Ruta
Descripción
GET
/categorias
Lista los proyectos del usuario.
POST
/categorias
Crea un proyecto nuevo (nombre, color opcional).
DELETE
/categorias/{id}
Elimina un proyecto (va a la papelera).
POST
/categorias/{id}/favorito
Alterna si el proyecto está marcado como favorito.
POST
/categorias/reordenar
Reordena los proyectos (orden: lista de ids).
Notas
Método
Ruta
Descripción
POST
/notas
Crea una nota (texto, categoria_id).
PUT
/notas/{id}
Edita el texto de una nota.
DELETE
/notas/{id}
Elimina una nota (va a la papelera).
Tareas con duración
No hay un paso de «iniciar» separado: crear una tarea de tipo duracion la deja inmediatamente en curso (inicio_en = ahora, estado = en_curso); crear una de tipo instantanea la crea ya finalizada, sin fin_en/duracion_segundos por diseño (es un evento puntual, no algo que se extiende en el tiempo).
Método
Ruta
Descripción
POST
/tareas
Crea una tarea y la arranca en el mismo paso (nombre, categoria_id, tipo: duracion|instantanea).
PUT
/tareas/{id}
Renombra una tarea.
DELETE
/tareas/{id}
Elimina una tarea (va a la papelera).
POST
/tareas/{id}/pausar
Pausa una tarea en curso.
POST
/tareas/{id}/reanudar
Reanuda una tarea pausada.
POST
/tareas/{id}/finalizar
Finaliza la tarea — calcula la duración total descontando el tiempo en pausa.
Tareas estilo Outlook
Un segundo tipo de tarea, independiente de las tareas con duración de arriba — con asunto, cuerpo, prioridad, fechas de inicio/vencimiento y categoría al estilo de Outlook To-Do (pensado para import/export .ics/.csv compatible).
Método
Ruta
Descripción
GET
/tareas-outlook
Lista, filtrable por estado/prioridad/categoria/q. ambito opcional: propias (por defecto), asignadas, compartidas o todas; con él cada fila lleva rol (dueno, asignada, compartida).
POST
/tareas-outlook
Crea una (asunto obligatorio; cuerpo, prioridad, fecha_inicio, fecha_vencimiento, categoria_outlook).
PUT
/tareas-outlook/{id}
Edita cualquier subconjunto de campos (solo actualiza los presentes en el body).
DELETE
/tareas-outlook/{id}
Elimina.
POST
/tareas-outlook/{id}/completar
Marca como completada.
Proyectos, checklist, asignación y más
Misma autenticación, mismo formato y mismos permisos (un token de solo lectura solo puede hacer GET).
Método
Ruta
Descripción
GET
/sync
Sin cursor: cursor actual (pídelo antes de la descarga inicial). Con ?cursor=N: cambios y eliminados desde entonces, cursor nuevo y hay_mas (limit hasta 1000). reiniciar: true = cursor de más de 30 días, descarga todo de nuevo.
GET/POST
/proyectos
Lista / crea proyectos (nombre, color). Equivale a /categorias.
PUT/DELETE
/proyectos/{id}
Renombra / manda a la papelera.
GET
/notas/{id}
Una nota.
POST
/notas/{id}/fijar
{"fijada": true|false}.
GET
/tareas-outlook/{id}
Detalle de una tarea (propia o asignada) con su checklist.
GET/POST
/tareas-outlook/{id}/checklist
Lista / añade una subtarea (texto, máx. 50).
POST
/checklist/{item_id}/alternar
Marca o desmarca una subtarea (recalcula el porcentaje).
POST
/tareas-outlook/{id}/asignar
{"companero_id": n} (solo del mismo despacho); sin él, desasigna.
GET
/companeros
Compañeros del despacho a quienes asignar.
GET
/mi-dia
Vencidas, de hoy, en curso y asignadas.
GET
/correo/mensajes/{id}/conversacion
Mensajes del mismo hilo.
POST
/correo/mensajes/{id}/tarea
Crea una tarea vinculada al correo (fecha_vencimiento opcional).
POST
/correo/mensajes/{id}/nota
Guarda el correo como nota.
GET/DELETE
/correo/programados[/{id}]
Envíos programados pendientes / cancela uno.
GET/DELETE
/correo/seguimientos[/{id}]
«Avísame si no responde» (todos=1 incluye cerrados) / cancela.
Marca todas como leídas / marca una / elimina una.
GET
/buscar?q=
Búsqueda en notas, tareas y correo (limit 1-20).
GET
/ia/consumo
Consultas de IA del mes del despacho y su tope (ilimitado si no hay).
GET
/comunicados
Avisos de Guilda vigentes para el usuario.
POST
/comunicados/{id}/cerrar
Cierra un aviso (los críticos no se pueden cerrar: 403).
Tareas: flujo completo
Todo lo que se hace con una tarea de lista en la web, también por API. Los permisos son los de siempre (dueño, colaborador, observador, asignado) y las mismas notificaciones: asignar, compartir, mencionar y desbloquear avisan a las personas afectadas. Área de token: tareas.
Método
Ruta
Descripción
POST
/tareas-outlook/{id}/estado
{"estado": "no_iniciada|en_progreso|completada|esperando|aplazada"}. 409tarea_bloqueada si espera a otras (también en /completar).
GET/POST
/tareas-outlook/{id}/dependencias
Qué la bloquea / {"depende_de_id": n} (409 si crearía un ciclo).
DELETE
/tareas-outlook/{id}/dependencias/{depende_de_id}
Quita la dependencia.
GET/POST
/tareas-outlook/{id}/comentarios
Lista / comenta (texto, con @menciones). Lo puede hacer quien ve la tarea.
DELETE
/tareas-outlook/{id}/comentarios/{comentario_id}
Borra un comentario (el suyo, o el dueño).
GET
/tareas-outlook/{id}/actividad
Historial de cambios.
GET/POST
/tareas-outlook/{id}/recordatorios
Lista / crea (avisar_en o atajo, canales).
DELETE/POST
/tareas-outlook/recordatorios/{rid}[/posponer]
Borra / pospone (opcion).
GET/POST
/tareas-outlook/{id}/compartir
Participantes / comparte (usuario_id, rol: colabora | observa; solo el dueño).
DELETE
/tareas-outlook/{id}/compartir/{usuario_id}
Quita a un participante (o se sale uno mismo).
POST
/tareas-outlook/{id}/cronometro/iniciar
Empieza a contar tiempo (proyecto_id si la tarea no tiene). Luego se pausa y finaliza con /tareas/{id}/....
GET
/tareas-outlook/{id}/tiempo
Tiempo registrado (tuyo y del equipo).
POST
/tareas-outlook/{id}/mover
{"persona_id", "fecha"}: reasigna y/o cambia el día.
Plan de la semana por persona (horas estimadas frente a capacidad).
GET/POST/DELETE
/tareas-outlook/vistas[/{id}]
Vistas guardadas: {nombre, filtros, compartida}.
GET/POST
/tareas-plantillas
Plantillas de tareas (nombre, items, compartida).
PUT/DELETE
/tareas-plantillas/{id}
Edita / borra.
POST
/tareas-plantillas/{id}/aplicar
Crea las tareas (fecha_inicio, proyecto_id o nuevo_proyecto, cliente_fiscal_id, asignada_a, encadenar).
GET/POST
/tareas-recurrentes
Tareas que se repiten (asunto, periodicidad, dia, mes).
POST/DELETE
/tareas-recurrentes/{id}[/alternar]
Activa/pausa · borra.
GET/POST
/tareas-reglas-vencimiento
«Una tarea por cada vencimiento del modelo X» (modelo, asunto con {cliente}/{modelo}/{periodo}, crear_dias_antes, vence_dias_antes).
POST/DELETE
/tareas-reglas-vencimiento/{id}[/alternar]
Activa/pausa · borra.
Calendario fiscal: flujo completo
Mismas reglas que la web: todo se limita al despacho del usuario, el expediente del cliente registra quién lo toca (las acciones por API quedan marcadas «vía API» en el registro de accesos) y los avisos por correo al cliente salen igual. Área de token: fiscal. Un cliente admite email, pais (ISO, p. ej. ES), idioma (es|ca|en|fr), recordatorios_portal y referencia_externa.
Método
Ruta
Descripción
GET
/fiscal/modelos?pais=
Modelos fiscales disponibles por país.
GET
/fiscal/clientes/{id}/resumen
Modelos, pendientes y próximos vencimientos.
GET
/fiscal/clientes/{id}/accesos
Registro de accesos al expediente (solo supervisores; RGPD).
GET/POST
/fiscal/clientes/{id}/documentos
Expediente: lista (metadatos) / sube hasta 10 archivos de 15 MB (multipart archivo, categoria) → resultado por archivo.
GET/DELETE
/fiscal/clientes/{id}/documentos/{doc}
Descarga (siempre como adjunto, nunca como página) / borra.
POST
/fiscal/vencimientos
Alta manual: cliente_id, modelo, periodo, fecha_limite; 409 vencimiento_duplicado.
GET
/fiscal/vencimientos
Filtros estado, cliente_id, desde, hasta, pais; paginación en SQL y X-Total-Count.
GET
/fiscal/vencimientos/{id}
Detalle con documentos, mensajes y si tiene constancia o justificante.
GET
/fiscal/vencimientos/propuestas?cliente_id=&anio=
Vista previa de lo que se generaría (con ya_existe).
POST
/fiscal/clientes/{id}/generar-vencimientos
{modelos?, anio?} sin duplicar; usa el país del cliente → {creados, ids, omitidos}.
POST
/fiscal/vencimientos/generar-masivo
{anio}: todos los clientes con modelos definidos, sin duplicar.
POST
/fiscal/vencimientos/{id}/presentado
Como en la web: constancia en PDF, justificante opcional (multipart justificante) y evento vencimiento.presentado.
POST
/fiscal/vencimientos/{id}/justificante
Sube el justificante oficial (imagen o PDF, 8 MB).
POST
/fiscal/vencimientos/{id}/constancia
Regenera la constancia en PDF.
GET
/fiscal/vencimientos/{id}/documentos[/{doc}]
Lo que sube el cliente desde el portal, la constancia y el justificante; descarga.
GET/POST
/fiscal/vencimientos/{id}/mensajes
Conversación con el cliente; al responder se le avisa por correo.
GET/PUT
/fiscal/recordatorios
Días de aviso al cliente antes/después, aviso al equipo y texto propio con marcas.
Lo que no está en la API a propósito: enviar a firma electrónica y cobrar por Stripe (acciones con efecto sobre terceros o dinero que se hacen desde la ficha del vencimiento, con revisión humana).
Adjuntos de notas, envíos, plantillas y administración del fichaje
Método
Ruta
Descripción
GET/POST
/notas/{id}/adjuntos
Lista (metadatos) / sube (multipart, varios adjunto): imágenes, PDF, texto o CSV; 5 MB cada uno, 5 por nota. Resultado por archivo.
GET/DELETE
/notas/adjuntos/{adjunto_id}
Descarga (?ver=1 en línea si es imagen) / borra.
GET
/correo/envios/{id}
Estado de un envío (pendiente, enviado, cancelado, error).
POST
/correo/envios/{id}/cancelar
Cancela un envío programado; {"como_borrador": true} lo conserva como borrador (409 si ya salió). DELETE /correo/programados/{id} lo descarta.
GET
/correo/plantillas/variables
Variables {{...}} disponibles.
GET/PUT/DELETE
/correo/plantillas/{id}
Ver (con ?cliente_fiscal_id= devuelve además renderizada y sin_resolver) / editar cualquier subconjunto / borrar.
POST
/correo/plantillas
Crea: nombre, asunto, cuerpo (HTML con variables), modelo.
GET
/fichaje/admin/resumen
Horas por trabajador del despacho (desde, hasta) y de la semana. Gestores de fichajes; un administrador global añade tenant_id.
GET
/fichaje/admin/usuarios/{id}
Datos y fichajes de un trabajador (el más reciente primero).
POST
/fichaje/admin/usuarios/{id}/corregir
Corrección auditable: tipo, marca_tiempo (hora REAL), corrige_a, nota. Inserta un fichaje nuevo (origen correccion_admin); no sobrescribe.
GET
/fichaje/admin/exportar.csv|pdf|json
Registro horario (desde, hasta, usuario_id). El JSON lleva el hash de cada fila.
GET
/fichaje/admin/verificar-integridad
Comprueba la cadena de hashes del registro horario.
Webhooks por API
Para que una integración se dé de alta sola. Solo un supervisor del despacho o un administrador (los webhooks sacan datos del despacho). La URL debe ser https y pública (se rechazan direcciones internas y no se siguen redirecciones). Área de token: webhooks.
Método
Ruta
Descripción
GET/POST
/webhooks
Lista / crea (url, eventos). El secreto solo se devuelve al crear.
GET
/webhooks/catalogo-eventos
Eventos disponibles.
GET/PUT/DELETE
/webhooks/{id}
Ver / cambiar (url, eventos, activo) / borrar. Los creados desde el Backoffice son de solo lectura aquí.
POST
/webhooks/{id}/rotar-secreto
Secreto nuevo (el anterior deja de valer al instante).
POST
/webhooks/{id}/probar
Encola un evento ping (202).
GET
/webhooks/{id}/entregas
Intentos recientes y estado de la cola.
POST
/webhooks/entregas/{cola_id}/reintentar
Reintenta una entrega fallida.
Dashboard, histórico y exportación
Método
Ruta
Descripción
GET
/dashboard
Resumen del día: proyectos, tareas activas, notas de hoy, correos sin leer.
GET
/historial
Histórico filtrable por desde/hasta/categoria_id/q.
GET
/export
Exporta el histórico — formato: json (por defecto) | csv | md, más desde/hasta/categoria_id.
Papelera
Método
Ruta
Descripción
GET
/papelera
Lista los elementos borrados (notas, tareas, proyectos).
POST
/papelera/{tipo}/{id}/restaurar
Restaura un elemento — tipo: nota|tarea|menu.
POST
/papelera/{tipo}/{id}/eliminar-definitivamente
Borra un elemento sin posibilidad de restaurarlo.
Correo
El cliente de correo propio de Guilda Work (cuentas IMAP/SMTP conectadas por el usuario, distinto del correo-como-herramienta de Stalwart, ver Asistente de IA (MCP)) — bandeja, carpetas, categorías propias, remitentes de confianza, reglas automáticas, firma y envío.
Método
Ruta
Descripción
GET
/correo/cuentas
Lista las cuentas de correo conectadas.
POST
/correo/cuentas
Conecta una cuenta nueva (host/puerto/usuario/contrasena IMAP, más SMTP opcional).
DELETE
/correo/cuentas/{id}
Desconecta una cuenta.
POST
/correo/cuentas/{id}/sincronizar
Sincroniza la bandeja (todas las carpetas IMAP se descubren solas).
GET
/correo/carpetas
Carpetas de una cuenta (cuenta_id).
GET
/correo/mensajes
Bandeja, filtrable por cuenta_id/carpeta/no_leidos/q/pospuestos.
Destaca (y opcionalmente fija una fecha de aviso).
POST
/correo/mensajes/{id}/posponer
Pospone hasta una fecha.
POST
/correo/mensajes/{id}/categoria
Asigna una categoría propia de Guilda Work.
POST
/correo/mensajes/{id}/mover
Mueve a otra carpeta IMAP.
POST
/correo/mensajes/lote/{accion}
Acción en lote sobre varios ids a la vez — accion: leido|destacar|mover|eliminar.
POST
/correo/enviar
Envía un correo. JSON (adjuntos en base64) o multipart (ficheros en adjuntos, mejor para archivos grandes). cc/bcc, en_respuesta_a, seguimiento_dias («avísame si no responde») y programar_para (YYYY-MM-DDTHH:MM: queda en cola, 202 con envio_id). Máx. 20 adjuntos y 25 MB; base64 inválido: 400 adjunto_invalido.
GET / POST
/correo/categorias
Categorías propias de Guilda Work (no se sincronizan con el servidor de correo).
DELETE
/correo/categorias/{id}
Elimina una categoría propia.
GET / POST
/correo/remitentes-confiables
Remitentes cuyas imágenes/enlaces se cargan sin aviso previo.
DELETE
/correo/remitentes-confiables/{id}
Quita un remitente de confianza.
GET / POST
/correo/reglas-categoria
Reglas que asignan categoría automáticamente por patrón de remitente.
DELETE
/correo/reglas-categoria/{id}
Elimina una regla.
GET
/correo/destinatarios-recientes
Autocompletado de destinatarios usados antes (q).
GET / POST
/correo/ajustes
Preferencias: densidad, marcar leído automático, límite de mensajes por sincronización.
POST
/correo/firma
Guarda la firma HTML de una cuenta (con o sin firma en respuestas).
Asistente de IA integrado
El chat del asistente embebido en la propia app (distinto de conectar Claude/ChatGPT por MCP contra tu instancia, ver Asistente de IA (MCP) para eso).
Método
Ruta
Descripción
GET
/ia/mensajes
Mensajes de la conversación activa con el asistente.
POST
/ia/mensaje
Envía un mensaje al asistente.
POST
/ia/confirmar
Confirma o cancela una acción sensible pendiente (p. ej. enviar un correo).
POST
/ia/vaciar
Abre una conversación nueva en blanco (la anterior se conserva en /ia/conversaciones).
GET
/ia/conversaciones
Lista las conversaciones del usuario (más reciente primero) y cuál está activa.
POST
/ia/conversaciones
Abre una conversación nueva y la deja activa.
POST
/ia/conversaciones/{id}/activar
Cambia la conversación activa: /ia/mensajes y /ia/mensaje pasan a trabajar con ella.
POST
/ia/conversaciones/{id}/renombrar
Cambia el título (titulo, máx. 60 caracteres). Por defecto es el inicio del primer mensaje.
DELETE
/ia/conversaciones/{id}
Elimina la conversación y sus mensajes.
GET / POST
/ia/ajustes
Modelo, modo autónomo y clave de API del proveedor de IA.
Herramientas conectadas
Método
Ruta
Descripción
GET
/herramientas
Catálogo de herramientas conectadas visibles para el usuario (mismo que la pantalla «Herramientas» de la web, sin «Chat» — el móvil usa un cliente Matrix nativo, ver la fila de abajo).
GET
/chat/config
URL del homeserver de Matrix/Synapse, para el cliente de chat nativo.
Esta es la API pensada para clientes propios (apps móviles, scripts, integraciones a medida). Para que un asistente de IA de terceros (Claude, ChatGPT, Codex) actúe directamente sobre tu instancia, la vía recomendada es MCP — ver Asistente de IA (MCP).