---
title: Comment purger une entité
slug: oip-next/qstu-comment-purger-une-entite
icon: {"lucideIcon":"📘"}
createdAt: 2024-10-08T09:07:52.000Z
---

L'entité `Project` offre une fonction `purge` pour supprimer des propriétés dans l'arbre des entités.

Signature : `<T>(project: T, options: object) => Promise<T>`

```javascript
await Entities('Project').purge(project, {
  Project: {
    Offer: {
      delete: ['price'],
      Pack: {
        delete: ['name']
      }
    }
  }
});
```

### Options

La configuration de la purge à réaliser se fait via l'objet `options` :

- La structure de l'arbre des entités doit être respectée ; `options` est ainsi de la forme : `{ Project: { [...] } }`.
- Les clés autorisées sont de deux types :
  - Le nom d'une entité (la casse doit être respectée).
  - Le littéral `delete` ; `delete` définit la liste des propriétés d'une entité à ne pas conserver.

:::hint{type="warning"}
Pour toutes les entités, certaines propriétés ne peuvent être supprimées : `id`, `createdAt`, `updatedAt`.

Pour l'entités Project, les propriétés `status` et `statusHistory` ne peuvent également pas être supprimées.
:::
