Docs

Eliminar datos

Cómo eliminar de Sypnia a una persona, una sesión, los source maps de una versión, un proyecto o una organización entera, qué quita cada eliminación, qué tan rápido, y qué se queda.

Aplica a MotorNube Al lanzar

Ver como Markdown
En esta página
  1. Qué puedes eliminar
  2. Eliminar a una persona
  3. Primero deja de enviarla, si no debe volver
  4. Elimina
  5. Comprueba
  6. Eliminar una sesión
  7. Eliminar los source maps de una versión
  8. Eliminar un proyecto
  9. Un solo problema
  10. Eliminar una organización o tu cuenta
  11. Qué tan rápido, exactamente
  12. Lo que la eliminación no alcanza
  13. Motor y Sypnia Cloud
  14. Ejemplo: a la tienda le piden olvidar a un cliente
  15. Relacionado

Esta página es para quien tiene que quitar algo de Sypnia: porque una persona pidió ser olvidada, porque una grabación captó lo que no debía, o porque un proyecto terminó. Aplica al motor de código abierto Motor y a Sypnia Cloud Nube. Las llamadas son las mismas; quién puede hacerlas cambia, y cada sección lo dice.

No tienes que eliminar nada para que los datos se vayan. Todo tiene un límite de edad, y Sypnia lo borra cuando lo pasa: ver Ubicación y retención de datos para Sypnia Cloud y Retención para un motor con alojamiento propio. Esta página trata de eliminar antes.

Qué puedes eliminar

QuéCómoQuién puedeListo
Una persona y todo lo ligado a ellaDELETE /v1/people/{person_id}Un token de API con admin. En Sypnia Cloud, también un dueño o un administrador, en la app.De las listas al instante, los archivos en menos de 24 horas
Una sesión, con sus eventos, su grabación y sus capturas de páginaDELETE /v1/sessions/{session}Lo mismoLo mismo
Los source maps de una versiónDELETE /v1/releases/{version}/sourcemapsUn token de API con adminAl instante
Un proyecto y todos sus datosMotor: sypnia project delete, con el token raíz. Sypnia Cloud: en la app, un dueño.Ver la secciónLa ingesta se detiene al instante, los archivos en menos de 24 horas
Una organización, o tu cuenta NubeEn la appUn dueño; tú, para tu propia cuentaVer la sección

En los ejemplos, https://api.sypnia.com es Sypnia Cloud. En un motor con alojamiento propio usa tu propia URL base, con las mismas rutas.

Eliminar a una persona

Úsalo para responder a una solicitud de ser olvidado. Una persona es quien tu app nombró con identify(); su id es el que eligió tu app.

  1. Primero deja de enviarla, si no debe volver

    Los eventos nuevos con el mismo id crean a la persona otra vez. Si la persona además retiró su consentimiento para ser grabada, asegúrate de que tu app ya no inicie el SDK para ella, o ya no llame a identify() con su id. Ver Privacidad y enmascarado.

  2. Elimina

    Terminal
    curl -X DELETE "https://api.sypnia.com/v1/people/u_0977" \
      -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
    Deberías ver

    202 Accepted, con cuántas sesiones se van y el momento límite en que todo archivo guardado habrá desaparecido:

    JSON
    { "person_id": "u_0977", "sessions": 3, "status": "deleting", "done_by": "2026-03-13T10:40:00Z" }
  3. Comprueba

    Terminal
    curl -i "https://api.sypnia.com/v1/people/u_0977" \
      -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
    Deberías ver
    404, al instante. Sus sesiones ya no están en ninguna lista ni búsqueda.

Qué quita:

  • El registro de la persona: su id, y el nombre y el correo que envió tu app, si los envió.
  • Cada una de sus sesiones: la línea de tiempo, la grabación, las capturas de página.
  • Sus eventos dentro de los archivos guardados. Los archivos de eventos crudos y los Parquet diarios que los contenían se escriben otra vez sin ellos.
  • Su lugar en la lista de personas a las que afectó cada problema. El problema conserva su conteo.
  • El ejemplo guardado de un problema, cuando venía de una de sus sesiones. Se reemplaza por otra ocurrencia, o queda vacío cuando no hay otra.

Qué conserva, porque no dice nada de la persona: los totales. Un problema sigue diciendo que afectó a 3 personas, una página sigue teniendo sus números de rendimiento, y los contadores de uso del mes no cambian.

Alguien a quien tu app nunca identificó no tiene registro de persona. Elimina sus visitas una por una, como sesiones.

Eliminar una sesión

Úsalo cuando una grabación captó algo que no debía, o para una visita de alguien a quien tu app nunca identificó.

Terminal
curl -X DELETE "https://api.sypnia.com/v1/sessions/c4e1a8f3d7b24c69a0e5d3b1f9c7a5e3" \
  -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
Deberías ver
204, sin cuerpo. La sesión sale de las listas al instante; sus archivos se quitan en menos de 24 horas.

Quita la sesión, sus eventos, su grabación y sus capturas de página. Los conteos de los problemas y los números de rendimiento se quedan como están.

No hay una llamada que elimine solo la grabación y deje la línea de tiempo. Si una pantalla muestra lo que no debe, primero enmascárala, para que las sesiones nuevas salgan limpias, y luego elimina las sesiones que se grabaron antes.

Eliminar los source maps de una versión

Los source maps contienen tu código fuente. Elimínalos cuando una versión se retira y no quieres que su código siga guardado, sin esperar los 90 días desde la última vez que se vio la versión.

Terminal
curl -X DELETE "https://api.sypnia.com/v1/releases/4f2a91c/sourcemaps" \
  -H "Authorization: Bearer $SYPNIA_ADMIN_TOKEN"
Deberías ver
204. Los stacks que ya estaban traducidos siguen legibles. Las fallas nuevas de esa versión muestran los nombres de los archivos compilados.

Eliminar un proyecto

Elimina el proyecto, sus llaves y tokens, y todos sus datos: problemas, sesiones, grabaciones, números, source maps. No se puede deshacer.

Motor En un motor con alojamiento propio, con el token raíz:

Terminal
sypnia project delete playground
Deberías ver
El comando te pide escribir otra vez el slug, y luego elimina. La ingesta de las llaves del proyecto se detiene al instante: las apps que sigan enviando son rechazadas. Los archivos guardados se quitan en menos de 24 horas.

Con Docker Compose, córrelo dentro del contenedor: docker compose exec sypnia sypnia project delete playground.

Lo mismo por la API es DELETE /v1/projects/{project_ref}?confirm=<slug>, con el token raíz. Ver la referencia de la API.

Nube En Sypnia Cloud un proyecto se elimina en la app, en la configuración del proyecto, y lo hace un dueño de la organización. La API responde 403 cloud_managed.

Un solo problema

Un problema se conserva mientras exista su proyecto, para que Sypnia pueda decir «volvió» meses después. Guarda la frase, el análisis, el estado, los conteos de cada día y un ejemplo de la falla: ninguna sesión, ninguna grabación.

  • Para dejar de oír de él: ignóralo. Un problema ignorado nunca alerta y nunca se reabre.
  • Para quitar lo que guarda sobre una persona: elimina a esa persona, como arriba.
  • Nube Para eliminar el problema mismo: un dueño o un administrador puede eliminarlo en la app. Si la misma falla ocurre otra vez, es un problema nuevo.
  • Motor La API del motor no tiene una llamada para eliminar un solo problema al lanzar. Su registro se va cuando se elimina el proyecto.

Eliminar una organización o tu cuenta Nube

Una organización. Un dueño la elimina en la configuración de la organización. Eso elimina todos sus proyectos y todos sus datos, como arriba, termina el plan y les quita el acceso a los miembros. Las cuentas de los miembros no se eliminan.

Tu cuenta. La eliminas en la configuración de tu cuenta. Sales de todas las organizaciones y tus datos de acceso se eliminan. No puedes eliminar tu cuenta mientras seas el último dueño de una organización: pásale la propiedad a otra persona, o elimina primero la organización.

Qué conserva Sypnia Cloud después de cualquiera de las dos:

Se conservaPor cuánto tiempoPor qué
Facturas y registros de pagoEl tiempo que exijan las normas contablesTenemos que poder mostrar qué se cobró.
Respaldos de la base de datos que todavía contienen los datosMáximo 7 díasLos respaldos no se editan. Vencen. No se restauran salvo para recuperarnos de una falla nuestra.
Logs de peticiones de nuestros servidores, con direcciones IP30 díasPara investigar abusos y fallas.

Qué tan rápido, exactamente

MomentoQué es cierto
La llamada respondeLa persona, la sesión o el proyecto ya no está en ninguna lista, búsqueda, respuesta de la API ni herramienta de MCP.
En menos de 24 horasCada archivo guardado se borra o se escribe otra vez sin los datos. Para una persona, done_by en la respuesta es ese momento.
Sypnia Cloud, en 7 días másEl último respaldo de la base de datos que los contenía ya venció.

En un motor con alojamiento propio, el segundo paso lo hace el worker. Si no está corriendo, nada se quita del bucket hasta que vuelva a correr.

Lo que la eliminación no alcanza

Sypnia puede eliminar lo que Sypnia guarda. No puede alcanzar las copias que ya salieron:

  • Las alertas ya entregadas. Un correo en la bandeja de alguien, o el cuerpo que guardó tu receptor de webhooks.
  • Lo que el agente envió al proveedor de IA. Se queda con ese proveedor el tiempo que ese proveedor guarde las peticiones. Las grabaciones y lo que se escribe nunca se envían. Ver Modelos y qué se envía.
  • Lo que tu agente de código leyó por MCP, y lo que haya escrito en una conversación o en un archivo.
  • Los pull requests Nube que Sypnia abrió en tu repositorio.
  • Tus propias copias: lo que exportaste por la API, los archivos Parquet diarios que copiaste a otro lugar.
  • En un motor con alojamiento propio: tus respaldos de la base de datos, y las versiones viejas de los objetos si encendiste el versionado del bucket. Vencer ambos te toca a ti. Ver Estructura del almacenamiento.

Motor y Sypnia Cloud

El motor de Sypnia y Sypnia Cloud, comparados
Motor de SypniaCódigo abierto, en tu propia infraestructuraSypnia CloudServicio pago, con un plan gratis
Quién puede eliminarQuien tenga un token de API con el alcance admin. Un proyecto: quien tenga el token raíz.Dueños y administradores, en la app, y tokens de API con admin. Un proyecto o la organización: solo dueños.
Quién hace la eliminaciónTu worker, en tu bucket y tu base de datos.Nosotros.
RespaldosTuyos. Los datos eliminados siguen ahí hasta que los venzas.Los respaldos de la base de datos vencen a los 7 días.
PruebaMira en tu propio bucket y tu base de datos.La API responde 404 al instante. No emitimos un certificado de eliminación.

Ejemplo: a la tienda le piden olvidar a un cliente

Un cliente de la tienda escribe para pedir que quiten sus datos. La tienda identifica a las personas con su propio id de usuario, así que soporte encuentra el id en el panel de la tienda: u_0977.

  1. La tienda elimina la cuenta del cliente en su propio sistema, para que la app ya no lo identifique.
  2. Alguien con un token admin corre DELETE /v1/people/u_0977. La respuesta dice 3 sesiones, listo mañana a las 10:40.
  3. Al instante, buscar u_0977 en Sypnia no encuentra nada. El problema que ese cliente encontró el mes pasado sigue diciendo «3 personas»; ya no dice quién fue la tercera.
  4. La tienda le responde al cliente.

Relacionado

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar