# 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: el motor de Sypnia (código abierto, en tu propia infraestructura) y Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/privacy/deleting-data/

Para agentes: Cómo se eliminan datos de Sypnia, en el motor de código abierto y en Sypnia Cloud: DELETE /v1/people/{person_id}, DELETE /v1/sessions/{session}, DELETE /v1/releases/{version}/sourcemaps y DELETE /v1/projects/{project_ref} con sus credenciales, qué quita cada uno, los tiempos (de las listas al instante, los objetos guardados en menos de 24 horas), qué se queda (totales, registros de problemas, respaldos, lo que ya salió de Sypnia), y la eliminación de una organización o de una cuenta en Sypnia Cloud.

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.

> **En palabras simples**
>
> Puedes eliminar a una persona, una visita o un proyecto entero, en cualquier momento. Desaparece de todas las listas al instante, y los archivos que hay detrás se van en menos de un día. Lo que se queda son totales que no dicen nada de nadie, como «este problema afectó a 3 personas».

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](https://docs.sypnia.com/es/cloud/data-location-and-retention) para Sypnia Cloud y [Retención](https://docs.sypnia.com/es/self-hosting/upgrades-backups-retention#retenci%C3%B3n) para un motor con alojamiento propio. Esta página trata de eliminar antes.

## Qué puedes eliminar

| Qué                                                                                        | Cómo                                                                                  | Quién puede                                                                                   | Listo                                                                |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [Una persona](#eliminar-a-una-persona) y todo lo ligado a ella                             | `DELETE /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](#eliminar-una-sesión), con sus eventos, su grabación y sus capturas de página | `DELETE /v1/sessions/{session}`                                                       | Lo mismo                                                                                      | Lo mismo                                                             |
| [Los source maps de una versión](#eliminar-los-source-maps-de-una-versión)                 | `DELETE /v1/releases/{version}/sourcemaps`                                            | Un token de API con `admin`                                                                   | Al instante                                                          |
| [Un proyecto](#eliminar-un-proyecto) y todos sus datos                                     | Motor: `sypnia project delete`, con el token raíz. Sypnia Cloud: en la app, un dueño. | Ver la sección                                                                                | La ingesta se detiene al instante, los archivos en menos de 24 horas |
| [Una organización, o tu cuenta](#eliminar-una-organización-o-tu-cuenta) **\[Nube]**        | En la app                                                                             | Un dueño; tú, para tu propia cuenta                                                           | Ver 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](https://docs.sypnia.com/es/sdks/privacy-and-masking).

### 2. Elimina

```bash
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

```bash
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ó.

```bash
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](https://docs.sypnia.com/es/privacy/masking), 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.

```bash
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:

```bash
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](https://docs.sypnia.com/es/api/projects-keys-and-tokens).

**\[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 conserva                                                   | Por cuánto tiempo                         | Por qué                                                                                           |
| ------------------------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Facturas y registros de pago                                  | El tiempo que exijan las normas contables | Tenemos que poder mostrar qué se cobró.                                                           |
| Respaldos de la base de datos que todavía contienen los datos | Máximo 7 días                             | Los respaldos no se editan. Vencen. No se restauran salvo para recuperarnos de una falla nuestra. |
| Logs de peticiones de nuestros servidores, con direcciones IP | 30 días                                   | Para investigar abusos y fallas.                                                                  |

## Qué tan rápido, exactamente

| Momento                     | Qué es cierto                                                                                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| La llamada responde         | La 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 horas        | Cada 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ás | El ú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](https://docs.sypnia.com/es/agent/models-and-what-is-sent).
- **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](https://docs.sypnia.com/es/self-hosting/storage-layout#reglas-en-el-bucket).

## Motor y Sypnia Cloud

|                           | Motor de Sypnia (código abierto, en tu propia infraestructura)                              | Sypnia Cloud (servicio pago, con un plan gratis)                                                              |
| ------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| Quién puede eliminar      | Quien 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ón | Tu worker, en tu bucket y tu base de datos.                                                 | Nosotros.                                                                                                     |
| Respaldos                 | Tuyos. Los datos eliminados siguen ahí hasta que los venzas.                                | Los respaldos de la base de datos vencen a los 7 días.                                                        |
| Prueba                    | Mira 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
