Eliminar datos de la organización
POST/v1/data_purges
IRREVERSIBLE: elimina definitivamente los recursos elegidos en TODOS los workspaces de la organización. En el panel la operación se confirma con un código enviado por correo. Por eso, un token que identifica a una persona (token personal, OAuth o llamada por el MCP) recibe 403: la persona hace la limpieza desde el panel. Solo los tokens de máquina pueden limpiar por la API, y solo cuando el token trae el scope dedicado dashboards/data_purges:write — concedido explícitamente: ningún otro scope lo implica (ni write, all, dashboards/all o dashboards/admin:write); sin él, 403 insufficient_scope. Su confirmación es confirm, que debe repetir el ID de la organización (de GET /organization) — una llamada repetida o dirigida a la organización equivocada no pasa por error. Exige data.purge (por defecto solo dueños de la organización) y acceso a todos los workspaces. Asíncrono: 202 con job_id.
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Limpieza programada; sígala en GET /data_purges/{id}.
Cuerpo ausente, JSON inválido o campos incompatibles.
Token bearer ausente o inválido.
Token válido, pero sin permiso para esta operación.
Recurso no encontrado en la organización actual.
confirm no coincide con el ID de la organización — no se eliminó nada.
Límite de solicitudes excedido.
Error inesperado en el servidor.