Saltar al contenido

Formato de la exportación de los datos de una organización

El propietario de una organización en LIA puede exportar todos sus datos desde Ajustes › Organizaciones › «Exportar los datos», también de una organización archivada. Esta página describe qué lleva esa exportación, archivo por archivo, y en qué formato: es el formato lia.organization-export versión 1. Lo que se añada más adelante subirá la versión, y nunca cambiará lo que ya había.

Cómo se entrega

  • Uno o varios archivos ZIP, las «partes», de 2 GiB como mucho cada una, que se llaman lia-organizacion-<id>-<AAAA-MM-DD>-parte-<n>-de-<N>.zip.
  • La primera parte lleva todos los datos (los archivos JSON); los archivos subidos van después, en las partes que hagan falta. Una exportación sin archivos es siempre una sola parte.
  • Se prepara aparte, y al acabar avisamos a quien la pidió. Se guarda 7 días; cada parte se descarga con un enlace que dura 60 minutos.
  • Una a la vez, y una nueva cada 24 horas como mucho. No cuesta nada.

Los archivos que la describen

  • README.txt, el primero de la primera parte: cómo está hecha, en inglés, con la dirección de esta página.
  • manifest.json, el último de la última parte: el formato y su versión, la organización, cuándo se preparó, por dónde se pidió, si lleva los archivos, cuántas partes tiene, cada entrada de cada parte (su ruta, su parte, su tamaño, su SHA-256 y, en una lista, cuántas filas lleva) y lo que no pudo entrar, con su porqué (omitted).
  • schemas/: el esquema JSON (draft-07) de cada clase de fila. Cada esquema dice todos los campos que puede llevar una fila, y ninguno más.

Cómo se leen

  • Un archivo .json lleva un objeto o una lista; un archivo .jsonl lleva una fila por línea (JSON Lines).
  • Las claves van en inglés, las de la API de LIA. Las fechas van en milisegundos desde el 1 de enero de 1970 (UTC); el manifiesto da también la suya en ISO 8601.
  • Las personas van por su id, y organization/people.json dice quién es cada una. deleted-user es una cuenta que se borró.
  • Cada fila sale tal como se guarda, pero solo con los campos de una lista cerrada: lo que no está en ella, no sale. Un archivo copiado en la exportación se nombra por su zipPath; un enlace a otro sitio se queda como enlace.

Los datos, archivo por archivo

En el orden en que se escriben. Debajo de cada uno, sus campos y su esquema.

organization/organization.json

JSON (un objeto). La organización: su id, su nombre, su estado, sus fechas y su propietario.

Campos: id, name, icon, status, ownerUid, createdAt, updatedAt, archivedAt, deletion. Esquema: organization.schema.json.

organization/people.json

JSON (una lista). Sus personas: de cada miembro, su id, su nombre, su email, su papel, sus equipos, su función, su estado y desde cuándo está; y quienes se fueron.

Campos: uid, name, email, role, teamIds, jobTitle, status, joinedAt, leftAt. Esquema: person.schema.json.

organization/teams.json

JSON (una lista). Sus equipos.

Campos: id, name, description, color, emoji, leadUids, status, createdAt, updatedAt. Esquema: team.schema.json.

organization/invitations.json

JSON (una lista). Sus invitaciones pendientes, con el email de la persona invitada.

Campos: id, email, role, invitedBy, status, createdAt, expiresAt. Esquema: invitation.schema.json.

organization/library.json

JSON (una lista). Su Biblioteca: lo que se ha compartido con la organización (con su política y sus equipos) y, si es suyo, el propio recurso.

Campos: id, kind, resourceId, name, description, access, status, policy, teams, teamPolicies, requiresPersonalConnection, sharedBy, createdAt. Esquema: grant.schema.json.

organization/audit.jsonl

JSON Lines. Su registro de auditoría: todas las filas, como las da el registro, con su IP.

Campos: id, action, group, at, actor, subject, details, ip. Esquema: auditEntry.schema.json.

work/space.json

JSON (un objeto). Los ajustes de Trabajo: sus etiquetas, su flujo y los ajustes de su IA.

Campos: organizationId, labels, defaultFlow, ai, files. Esquema: workSpace.schema.json.

work/projects.jsonl

JSON Lines. Los proyectos de Trabajo, con sus hitos.

Campos: id, organizationId, key, name, emoji, color, description, mentionUids, itemRefs, objectives, leadUid, teamIds, memberUids, status, health, startDate, targetDate, priority, visibility, flow, estimateUnit, labelIds, links, weeklyClose, weeklyCloseDraft, rollup, archived, createdBy, createdAt, updatedAt, milestones. Esquema: workProject.schema.json.

work/updates.jsonl

JSON Lines. Las actualizaciones de los proyectos.

Campos: id, organizationId, projectId, milestoneId, teamId, author, health, body, mentionUids, itemRefs, createdAt. Esquema: workUpdate.schema.json.

work/items.jsonl

JSON Lines. Las tareas; de una que se dio a un agente, cuál, quién se la dio y cómo va su trabajo (agent).

Campos: id, organizationId, projectId, key, number, title, description, mentionUids, itemRefs, type, statusId, statusCategory, priority, milestoneId, parentId, createdBy, source, assigneeUids, teamIds, watcherUids, startDate, dueDate, estimate, spent, blocked, blockedBy, blocks, related, duplicateOf, duplicatedBy, labelIds, rank, archived, createdAt, updatedAt, lastActivityAt, startedAt, completedAt, statusChangedAt, commentCount, assetCount, subtaskCount, subtaskDoneCount, agent. Esquema: workItem.schema.json.

work/comments.jsonl

JSON Lines. Los comentarios de las tareas.

Campos: id, organizationId, projectId, itemId, author, body, mentionUids, itemRefs, createdAt, editedAt. Esquema: workComment.schema.json.

work/activity.jsonl

JSON Lines. La actividad de Trabajo.

Campos: id, organizationId, projectId, itemId, itemKey, level, milestoneId, milestoneName, milestoneNames, type, from, to, fields, subjectUids, actor, at. Esquema: workEvent.schema.json.

work/views.jsonl

JSON Lines. Las vistas compartidas (nunca las que alguien no compartió).

Campos: id, organizationId, projectId, name, kind, filter, sort, descending, groupBy, lanesBy, properties, portfolio, shared, ownerUid, createdAt, updatedAt. Esquema: workView.schema.json.

work/materials.jsonl

JSON Lines. Los materiales de los proyectos: enlaces y archivos.

Campos: id, organizationId, projectId, milestoneId, itemId, itemKey, commentId, updateId, type, kind, title, description, url, author, teamIds, labelIds, createdAt, file. Esquema: workAsset.schema.json.

work/agent-runs.jsonl

JSON Lines. Las ejecuciones de los agentes en las tareas: qué agente, en qué tarea, quién la lanzó y quién la detuvo, cómo acabó y lo que gastó. No lleva lo que pidió aprobar ni lo que propuso.

Campos: id, organizationId, projectId, itemId, itemKey, agentId, agentName, responsibleUid, trigger, triggeredBy, chatId, state, reason, stoppedBy, credits, attempt, createdAt, startedAt, endedAt. Esquema: workAgentRun.schema.json.

work/agent-budgets.jsonl

JSON Lines. Los límites de gasto de los agentes por organización, proyecto y tarea. Incluye las políticas sin límite; una revisión cero indica que aún no hubo una edición humana.

Campos: id, organizationId, version, revision, period, limitCredits, updatedAt, updatedByUid, scope. Esquema: workBudgetPolicy.schema.json.

work/agent-budget-changes.jsonl

JSON Lines. El historial de cambios de cada límite: revisión, importe anterior y nuevo, fecha y persona que lo cambió.

Campos: id, organizationId, version, revision, previousLimitCredits, limitCredits, changedAt, changedByUid, scope. Esquema: workBudgetChange.schema.json.

work/agent-budget-usage.jsonl

JSON Lines. Los créditos gastados y reservados desde que empezó el seguimiento de cada ámbito. No es una factura ni reconstruye el gasto anterior al seguimiento.

Campos: id, organizationId, version, period, reservedCredits, spentCredits, firstTrackedAt, updatedAt, scope. Esquema: workBudgetUsage.schema.json.

work/agent-budget-operations.jsonl

JSON Lines. Las reservas de modelo, conocimiento y ejecución cloud, con su tarea, ejecución, estado e importes. Una reserva pendiente sigue retenida hasta recibir la confirmación; este registro no genera un segundo cobro.

Campos: id, organizationId, projectId, itemId, runId, version, kind, state, quotedCredits, reservedCredits, spentCredits, createdAt, updatedAt, receipt. Esquema: workBudgetOperation.schema.json.

work/tool-requests.jsonl

JSON Lines. Los metadatos de las solicitudes de herramientas de los agentes: tarea, ejecución, estado, fechas y decisión de aprobación o rechazo. No incluye el contenido solicitado.

Campos: id, organizationId, projectId, itemId, runId, state, revision, createdAt, updatedAt, expiresAt, contentOmitted, decision. Esquema: workToolRequest.schema.json.

work/code-connections.jsonl

JSON Lines.

Campos: id, organizationId, provider, state, revision, connectedByUid, updatedAt, contentOmitted. Esquema: workCodeConnection.schema.json.

work/code-repositories.jsonl

JSON Lines.

Campos: id, organizationId, projectId, connectionId, provider, repositoryId, access, enabled, revision, updatedAt, contentOmitted. Esquema: workCodeRepository.schema.json.

work/code-task-repositories.jsonl

JSON Lines.

Campos: bindingId, organizationId, projectId, itemId, addedByUid, addedAt, contentOmitted. Esquema: workCodeTaskRepository.schema.json.

work/code-pull-requests.jsonl

JSON Lines.

Campos: id, organizationId, projectId, itemId, bindingId, repositoryId, number, state, headCommit, mergeCommit, checks, review, checkedAt, contentOmitted. Esquema: workCodePullRequest.schema.json.

work/contexts.jsonl

JSON Lines. El contexto publicado de la organización, sus equipos, proyectos y tareas, y el de personas compartido con la organización. No incluye borradores ni contexto personal sin compartir.

Campos: id, createdAt, scope, published. Esquema: workContext.schema.json.

work/memories.jsonl

JSON Lines. Las memorias de los proyectos, con su procedencia, vigencia y estado de revisión.

Campos: id, kind, state, title, body, sourceItemId, sourceRunId, proposedByUid, publishedByUid, publishedAt, validFrom, validUntil, supersedesId, revision, createdAt, updatedAt, contentOmitted, scope, sources. Esquema: workMemory.schema.json.

work/result-reviews.jsonl

JSON Lines. Los criterios de aceptación y el estado actual de revisión de cada tarea.

Campos: id, organizationId, projectId, itemId, revision, criteriaRevision, state, updatedAt, criteria, submission, decision. Esquema: workResultReview.schema.json.

work/result-submissions.jsonl

JSON Lines. Las versiones presentadas del resultado, con sus entregables y evidencias.

Campos: id, organizationId, projectId, itemId, criteriaRevision, summary, submittedAt, criteria, evidence, deliverables, submittedBy. Esquema: workResultSubmission.schema.json.

work/result-decisions.jsonl

JSON Lines. Las decisiones de aceptación o petición de cambios y sus comentarios.

Campos: id, organizationId, projectId, itemId, submissionId, outcome, byUid, at, comment. Esquema: workResultDecision.schema.json.

work/project-documents.jsonl

JSON Lines. Las fichas de documentos del proyecto conservados desde resultados aceptados, con su procedencia y estado.

Campos: id, organizationId, projectId, itemId, submissionId, state, acceptedByUid, acceptedAt, revision, updatedAt, errorCode, source. Esquema: workProjectDocument.schema.json.

company/agents.jsonl

JSON Lines. Los agentes de la organización.

Campos: id, title, description, image, context, _config, _availableFunctions, _dynamicToolDiscovery, _mode, _knowledge, _resources, _apiConnectors, _mcpServers, _integrations, _work, _responsibleUid, _createdAt, _updatedAt, agentConfig, agentTools, handoffs. Esquema: agent.schema.json.

company/agent-systems.jsonl

JSON Lines. Sus sistemas de agentes.

Campos: id, title, description, image, rootAgentId, agentIds, systemIds, _responsibleUid, _createdAt, _updatedAt. Esquema: agentSystem.schema.json.

company/chatbots.jsonl

JSON Lines. Sus chatbots.

Campos: id, title, description, image, active, maxSessionTimeout, paymentRequired, maxFreeMessages, defaultFreemiumMessage, stripePaymentURL, availableRequestsPerPayment, _responsibleUid, _createdAt, _updatedAt, chat. Esquema: chatbot.schema.json.

company/channels.jsonl

JSON Lines. Sus canales: su clase, su nombre, sus chatbots y sus ajustes; nunca cómo se autentican.

Campos: id, type, title, description, image, chatbots, rateLimit, dates, allowedDomains, isActive, paymentRequired, maxFreeMessages, defaultFreemiumMessage, stripePaymentURL, availableRequestsPerPayment, freemiumChatbots, stripePaymentLinksAvailableRequests, widget, _responsibleUid, _createdAt, _updatedAt, voiceConfig, email. Esquema: channel.schema.json.

company/tasks.jsonl

JSON Lines. Sus tareas.

Campos: id, title, description, visibility, status, _executedAt, image, keepChat, _chatId, _responsibleUid, _createdAt, _updatedAt, steps, _cron, _user. Esquema: task.schema.json.

company/crons.jsonl

JSON Lines. Sus tareas programadas.

Campos: id, title, description, visibility, status, _executedAt, image, keepChat, _chatId, _responsibleUid, _createdAt, _updatedAt, steps, _cron, _user. Esquema: task.schema.json.

company/agentic-tasks.jsonl

JSON Lines. Sus tareas agénticas.

Campos: id, title, description, agentSystemId, initialMessage, status, _executedAt, image, planId, _disabled, _disabledReason, _disabledAt, timeZone, locale, _chatId, _runId, _responsibleUid, _createdAt, _updatedAt, executions, _cron, _user. Esquema: agenticTask.schema.json.

company/agentic-crons.jsonl

JSON Lines. Sus tareas agénticas programadas.

Campos: id, title, description, agentSystemId, initialMessage, status, _executedAt, image, planId, _disabled, _disabledReason, _disabledAt, timeZone, locale, _chatId, _runId, _responsibleUid, _createdAt, _updatedAt, executions, _cron, _user. Esquema: agenticTask.schema.json.

company/task-executions.jsonl

JSON Lines. Las ejecuciones de sus tareas agénticas.

Campos: id, chatId, runId, status, executedAt, errorMessage, _responsibleUid. Esquema: taskExecution.schema.json.

company/batches.jsonl

JSON Lines. Sus lotes. Sus datos y sus resultados van en company/files/batches/.

Campos: id, title, description, image, dataFormat, resultDataFormat, forceJSONResponse, prompt, status, currentRow, totalRows, _chatId, _responsibleUid, _createdAt, _updatedAt, message, data, result. Esquema: batch.schema.json.

company/plans.jsonl

JSON Lines. Sus planes, con sus elementos, sus ejecuciones y sus memorias.

Campos: id, title, description, strategy, agentSystemId, status, createdBy, createdByAgentSystemId, color, horizon, goals, phases, cron, agenticTaskId, stats, _responsibleUid, _createdAt, _updatedAt, items, executions, memories. Esquema: plan.schema.json.

company/api-connectors.jsonl

JSON Lines. Sus conectores de API: qué hacen (su nombre, su descripción, sus operaciones y el esquema de sus parámetros); nunca adónde llaman ni con qué claves.

Campos: id, name, description, image, method, parametersType, _createdAt, _updatedAt, parameters. Esquema: apiConnector.schema.json.

company/mcp-servers.jsonl

JSON Lines. Sus servidores MCP: qué ofrecen; nunca adónde llaman ni con qué claves.

Campos: id, name, description, image, transport, prefix, readOnlyHintTrust, _createdAt, _updatedAt. Esquema: mcpServer.schema.json.

company/integrations.jsonl

JSON Lines. Sus cuentas conectadas: el proveedor, la cuenta, los permisos y las fechas; nada de su acceso.

Campos: provider, isSandbox, accountId, accountLabel, scopes, subdomain, _createdAt, _updatedAt. Esquema: integration.schema.json.

company/triggers.jsonl

JSON Lines. Los disparadores de esas cuentas, con su instrucción.

Campos: id, provider, event, accountId, title, filters, maxRunsPerDay, agentSystemId, prompt, mailbox, status, createdAt, updatedAt, lastEventAt, lastRunAt, _responsibleUid, target. Esquema: trigger.schema.json.

conversations/conversations.jsonl

JSON Lines. Cada conversación de la organización (sus canales, sus chatbots, sus agentes y sus tareas): su clase, su pieza, su título, sus fechas y el contacto tal como se guardó.

Campos: id, title, description, members, _channelId, _chatbotId, _isAgent, _baseAgentId, _agentSystemId, _createdAt, _updatedAt, lastMessageAt, _humanTakeover. Esquema: conversation.schema.json.

conversations/cases.jsonl

JSON Lines. Los casos de esas conversaciones.

Campos: chatId, status, since, cycle, openedAt, lastCustomerAt, answeredAt, owedSince, firstReplyAt, lastReplyAt, handledBy, waitingOn, dueAt, resolvedAt, resolution, closedReason, reopened, reopenedAt, firstReplyMs, resolutionMs, updatedAt. Esquema: case.schema.json.

conversations/outbox.jsonl

JSON Lines. Las respuestas que salieron por email: remitente, destinatario, asunto, texto y fecha.

Campos: id, chatId, messageId, status, createdAt, envelope. Esquema: outbox.schema.json.

conversations/messages/

JSON Lines. Un archivo por conversación (<conversación>.jsonl): cada mensaje, quién lo escribió (el cliente, LIA, deleted-user…), su texto, su fecha y sus adjuntos (su zipPath o su enlace).

Campos: id, _createdAt, text, system, quickReplies, finishReason, _thinkingContent, user, _knowledgeCitations, _providerReply, attachments, email. Esquema: message.schema.json.

knowledge/folders.jsonl

JSON Lines. Sus carpetas de conocimiento.

Campos: id, name, description, image, icon, tags, documentCount, byteSize, _createdAt, _updatedAt. Esquema: knowledgeFolder.schema.json.

knowledge/documents.jsonl

JSON Lines. Sus documentos: sus datos (los originales van en knowledge/files/).

Campos: id, folderId, name, kind, sourceType, originUrl, mimeType, byteSize, status, language, media, website, createdAt, updatedAt, indexedAt, zipPath, omitted. Esquema: knowledgeDocument.schema.json.

knowledge/pieces.jsonl

JSON Lines. Las piezas escritas a mano en sus carpetas.

Campos: folderId, documentId, id, ordinal, title, body. Esquema: knowledgePiece.schema.json.

knowledge/sources.jsonl

JSON Lines. Sus fuentes: lo que se configuró (de un rastreo de una web, su configuración; no sus páginas).

Campos: id, folderId, config, createdAt, updatedAt, lastPublishedAt. Esquema: knowledgeSource.schema.json.

Los archivos subidos

Si la exportación lleva los archivos, van en estas carpetas, tal cual se subieron:

  • work/files/<material>/<nombre>: los archivos de Trabajo.
  • conversations/files/<conversación>/<mensaje>/<n>-<nombre>: los adjuntos de los mensajes y de los correos de las conversaciones de la organización.
  • knowledge/files/<carpeta>/<documento>/<nombre>: los originales y las notas de sus documentos de conocimiento.
  • company/files/batches/<lote>/<data|result>-<nombre>: los datos de los lotes y sus resultados.

Las imágenes, los logotipos y los audios de voz se quedan como enlaces. Un adjunto que no es de la organización (no es de sus canales, de su Trabajo ni de su cuenta) no se copia.

Lo que no pudo entrar va en omitted del manifiesto, con su ruta y su porqué:

  • not_found: ya no estaba;
  • unreadable: no se pudo leer;
  • outside: no es de la organización;
  • knowledge_unavailable: las piezas escritas a mano no llegaron a tiempo.

Lo que nunca lleva

Algunas cosas no se exportan nunca:

  • Lo privado de cada miembro: sus chats y plantillas en el espacio de la organización (también los de quien pide la exportación), sus vistas sin compartir, su bandeja, sus preferencias y lo que ha leído, y los borradores de los cierres de los viernes mientras no se publican.
  • Ningún secreto ni credencial: ni el token de un canal, ni las claves de acceso de WhatsApp, Telegram o Instagram, ni las direcciones, cabeceras y claves de los conectores de API y de los servidores MCP, ni el acceso de las cuentas conectadas, ni los secretos de sus disparadores.
  • Lo que el servicio usa por dentro: los vectores, los fragmentos y el texto extraído del conocimiento (se rehacen desde los originales, que sí van), los índices de búsqueda de Trabajo, las reservas de subida, las ejecuciones y las trazas de las conversaciones (de un agente que trabaja en una tarea va su resumen, en work/agent-runs.jsonl), las copias de los cobros, las páginas de los rastreos de webs, y los cerrojos, las colas y los contadores de límites.
  • Nada de otra organización ni del espacio personal de nadie.

Si el propietario elimina su cuenta

Una organización suya en la que no queda nadie más activo, o una archivada, se guarda 30 días, archivada y sin que nadie pueda abrirla, y después se borra entera. Al eliminar su cuenta, su propietario recibe un enlace con el que, durante esos 30 días y sin cuenta, puede pedir hasta 3 exportaciones con este mismo formato y descargarlas.