Entorno de PRE: solo datos de prueba. Los correos solo llegan al equipo y los cobros son de prueba.
Guilda WorkDevelopers

INTEGRACIÓN

Referencia de la API

Todos los endpoints REST, agrupados por recurso.

URL base y formato

text
https://tu-hostname/api/v1

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.

Meta

MétodoRutaDescripción
GET/api/v1/openapi.jsonDocumento 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

MecanismoCómo funciona
VersiónCada 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ímitePor 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 permitidasAl 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 pasosCada 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 servicioGET /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.
IdempotenciaEn 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.
TrazabilidadCada 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 externasNotas, 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ónlimit/offset y total en X-Total-Count.
SincronizaciónGET /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».
HTTPSignificado en esta API
400Datos de entrada inválidos: campo obligatorio ausente, formato incorrecto, valor fuera de rango.
401Token ausente, revocado o incorrecto (ver Autenticación).
404El recurso no existe, o existe pero pertenece a otro usuario — nunca se distingue entre ambos casos, para no filtrar si un id ajeno existe.
405Método HTTP no soportado para esa ruta.
409Conflicto — por ejemplo, /auth/registro con un email ya registrado.
429Lí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étodoRutaDescripción
POST/auth/registroCrea una cuenta nueva y devuelve un token.
POST/auth/loginInicia sesión y devuelve un token nuevo.
POST/auth/logoutRevoca el token de la propia petición.
GET/auth/meDatos de la cuenta autenticada.

Proyectos (categorías)

MétodoRutaDescripción
GET/categoriasLista los proyectos del usuario.
POST/categoriasCrea un proyecto nuevo (nombre, color opcional).
DELETE/categorias/{id}Elimina un proyecto (va a la papelera).
POST/categorias/{id}/favoritoAlterna si el proyecto está marcado como favorito.
POST/categorias/reordenarReordena los proyectos (orden: lista de ids).

Notas

MétodoRutaDescripción
POST/notasCrea 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étodoRutaDescripción
POST/tareasCrea 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}/pausarPausa una tarea en curso.
POST/tareas/{id}/reanudarReanuda una tarea pausada.
POST/tareas/{id}/finalizarFinaliza 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étodoRutaDescripción
GET/tareas-outlookLista, 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-outlookCrea 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}/completarMarca 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étodoRutaDescripción
GET/syncSin 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/proyectosLista / 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}/checklistLista / añade una subtarea (texto, máx. 50).
POST/checklist/{item_id}/alternarMarca o desmarca una subtarea (recalcula el porcentaje).
POST/tareas-outlook/{id}/asignar{"companero_id": n} (solo del mismo despacho); sin él, desasigna.
GET/companerosCompañeros del despacho a quienes asignar.
GET/mi-diaVencidas, de hoy, en curso y asignadas.
GET/correo/mensajes/{id}/conversacionMensajes del mismo hilo.
POST/correo/mensajes/{id}/tareaCrea una tarea vinculada al correo (fecha_vencimiento opcional).
POST/correo/mensajes/{id}/notaGuarda 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.
GET/correo/plantillasPlantillas de correo.
GET/notificacionesÚltimas (limit, máx. 100) y no_leidas.
POST/DELETE/notificaciones/leidas, /notificaciones/{id}/leida, /notificaciones/{id}Marca todas como leídas / marca una / elimina una.
GET/buscar?q=Búsqueda en notas, tareas y correo (limit 1-20).
GET/ia/consumoConsultas de IA del mes del despacho y su tope (ilimitado si no hay).
GET/comunicadosAvisos de Guilda vigentes para el usuario.
POST/comunicados/{id}/cerrarCierra 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étodoRutaDescripción
POST/tareas-outlook/{id}/estado{"estado": "no_iniciada|en_progreso|completada|esperando|aplazada"}. 409 tarea_bloqueada si espera a otras (también en /completar).
GET/POST/tareas-outlook/{id}/dependenciasQué 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}/comentariosLista / 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}/actividadHistorial de cambios.
GET/POST/tareas-outlook/{id}/recordatoriosLista / crea (avisar_en o atajo, canales).
DELETE/POST/tareas-outlook/recordatorios/{rid}[/posponer]Borra / pospone (opcion).
GET/POST/tareas-outlook/{id}/compartirParticipantes / 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/iniciarEmpieza a contar tiempo (proyecto_id si la tarea no tiene). Luego se pausa y finaliza con /tareas/{id}/....
GET/tareas-outlook/{id}/tiempoTiempo registrado (tuyo y del equipo).
POST/tareas-outlook/{id}/mover{"persona_id", "fecha"}: reasigna y/o cambia el día.
POST/tareas-outlook/{id}/restaurarSaca de la papelera.
DELETE/checklist/{item_id}Borra una subtarea.
POST/tareas-outlook/lote{"ids": [...], "accion": "completar|estado|prioridad|fecha|asignar|proyecto|seccion", "valor": ".."} (máx. 200) → {ok, fallos}.
GET/tareas-outlook/tableroTareas agrupadas por estado.
GET/tareas-outlook/carga?semana=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-plantillasPlantillas de tareas (nombre, items, compartida).
PUT/DELETE/tareas-plantillas/{id}Edita / borra.
POST/tareas-plantillas/{id}/aplicarCrea las tareas (fecha_inicio, proyecto_id o nuevo_proyecto, cliente_fiscal_id, asignada_a, encadenar).
GET/POST/tareas-recurrentesTareas 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étodoRutaDescripción
GET/fiscal/modelos?pais=Modelos fiscales disponibles por país.
GET/fiscal/clientes/{id}/resumenModelos, pendientes y próximos vencimientos.
GET/fiscal/clientes/{id}/accesosRegistro de accesos al expediente (solo supervisores; RGPD).
GET/POST/fiscal/clientes/{id}/documentosExpediente: 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/vencimientosAlta manual: cliente_id, modelo, periodo, fecha_limite; 409 vencimiento_duplicado.
GET/fiscal/vencimientosFiltros 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}/presentadoComo en la web: constancia en PDF, justificante opcional (multipart justificante) y evento vencimiento.presentado.
POST/fiscal/vencimientos/{id}/justificanteSube el justificante oficial (imagen o PDF, 8 MB).
POST/fiscal/vencimientos/{id}/constanciaRegenera 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}/mensajesConversación con el cliente; al responder se le avisa por correo.
GET/PUT/fiscal/recordatoriosDías de aviso al cliente antes/después, aviso al equipo y texto propio con marcas.
GET/fiscal/papeleraClientes y vencimientos borrados.
POST/fiscal/papelera/{cliente_fiscal|vencimiento_fiscal}/{id}/restaurarRecupera un elemento.

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étodoRutaDescripción
GET/POST/notas/{id}/adjuntosLista (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}/cancelarCancela un envío programado; {"como_borrador": true} lo conserva como borrador (409 si ya salió). DELETE /correo/programados/{id} lo descarta.
GET/correo/plantillas/variablesVariables {{...}} 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/plantillasCrea: nombre, asunto, cuerpo (HTML con variables), modelo.
GET/fichaje/admin/resumenHoras 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}/corregirCorrecció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|jsonRegistro horario (desde, hasta, usuario_id). El JSON lleva el hash de cada fila.
GET/fichaje/admin/verificar-integridadComprueba 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étodoRutaDescripción
GET/POST/webhooksLista / crea (url, eventos). El secreto solo se devuelve al crear.
GET/webhooks/catalogo-eventosEventos 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-secretoSecreto nuevo (el anterior deja de valer al instante).
POST/webhooks/{id}/probarEncola un evento ping (202).
GET/webhooks/{id}/entregasIntentos recientes y estado de la cola.
POST/webhooks/entregas/{cola_id}/reintentarReintenta una entrega fallida.

Dashboard, histórico y exportación

MétodoRutaDescripción
GET/dashboardResumen del día: proyectos, tareas activas, notas de hoy, correos sin leer.
GET/historialHistórico filtrable por desde/hasta/categoria_id/q.
GET/exportExporta el histórico — formato: json (por defecto) | csv | md, más desde/hasta/categoria_id.

Papelera

MétodoRutaDescripción
GET/papeleraLista los elementos borrados (notas, tareas, proyectos).
POST/papelera/{tipo}/{id}/restaurarRestaura un elemento — tipo: nota|tarea|menu.
POST/papelera/{tipo}/{id}/eliminar-definitivamenteBorra 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étodoRutaDescripción
GET/correo/cuentasLista las cuentas de correo conectadas.
POST/correo/cuentasConecta una cuenta nueva (host/puerto/usuario/contrasena IMAP, más SMTP opcional).
DELETE/correo/cuentas/{id}Desconecta una cuenta.
POST/correo/cuentas/{id}/sincronizarSincroniza la bandeja (todas las carpetas IMAP se descubren solas).
GET/correo/carpetasCarpetas de una cuenta (cuenta_id).
GET/correo/mensajesBandeja, filtrable por cuenta_id/carpeta/no_leidos/q/pospuestos.
GET/correo/mensajes/{id}Lee un mensaje completo, con sus adjuntos.
GET/correo/mensajes/{mensaje_id}/adjuntos/{adjunto_id}Descarga un adjunto.
DELETE/correo/mensajes/{id}Elimina un mensaje.
POST/correo/mensajes/{id}/leidoMarca leído/no leído.
POST/correo/mensajes/{id}/destacarDestaca (y opcionalmente fija una fecha de aviso).
POST/correo/mensajes/{id}/posponerPospone hasta una fecha.
POST/correo/mensajes/{id}/categoriaAsigna una categoría propia de Guilda Work.
POST/correo/mensajes/{id}/moverMueve 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/enviarEnví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/categoriasCategorí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-confiablesRemitentes cuyas imágenes/enlaces se cargan sin aviso previo.
DELETE/correo/remitentes-confiables/{id}Quita un remitente de confianza.
GET / POST/correo/reglas-categoriaReglas que asignan categoría automáticamente por patrón de remitente.
DELETE/correo/reglas-categoria/{id}Elimina una regla.
GET/correo/destinatarios-recientesAutocompletado de destinatarios usados antes (q).
GET / POST/correo/ajustesPreferencias: densidad, marcar leído automático, límite de mensajes por sincronización.
POST/correo/firmaGuarda 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étodoRutaDescripción
GET/ia/mensajesMensajes de la conversación activa con el asistente.
POST/ia/mensajeEnvía un mensaje al asistente.
POST/ia/confirmarConfirma o cancela una acción sensible pendiente (p. ej. enviar un correo).
POST/ia/vaciarAbre una conversación nueva en blanco (la anterior se conserva en /ia/conversaciones).
GET/ia/conversacionesLista las conversaciones del usuario (más reciente primero) y cuál está activa.
POST/ia/conversacionesAbre una conversación nueva y la deja activa.
POST/ia/conversaciones/{id}/activarCambia la conversación activa: /ia/mensajes y /ia/mensaje pasan a trabajar con ella.
POST/ia/conversaciones/{id}/renombrarCambia 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/ajustesModelo, modo autónomo y clave de API del proveedor de IA.

Herramientas conectadas

MétodoRutaDescripción
GET/herramientasCatá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/configURL 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).