---
title: Supprimer une entité
slug: oip-next/1_Hj-supprimer-une-entite
icon: {"lucideIcon":"📘"}
createdAt: 2025-12-02T09:11:58.000Z
---

# Vue d’ensemble

Chaque entité dispose d'une fonction de suppression : `delete[EntityName]`.

:::BlockQuote
**Info**
Cette fonction supprime l'entité en base de données.
:::

# Prérequis

Une entité ne peut être supprimée que si elle n'a pas d'entités enfants.

Pour ignorer cette contrainte, il est nécessaire de passer l'option `{ withChildren: true }` à la fonction `delete[EntityName]`.

:::BlockQuote
**Info**
L'option `{ withChildren: true }` a pour effet de supprimer l'entité ainsi que toutes ses sous-entités.
:::

# Entité racine

```javascript
// Delete a `Project` entity
let project1;

project1 = await createProject();
await deleteProject(project1);

// Delete a `Project` entity and all entities depending on
let project2, grantee1, grantee2;

project2 = await createProject();
grantee1 = await createGrantee(project2);
grantee2 = await createGrantee(project2);
await deleteProject(project2, { withChildren: true });
```

# Entité non racine

```javascript
let project;

// Delete a `Grantee` entity
let grantee1;

grantee1 = await createGrantee(project);
await deleteGrantee(grantee1);

// Delete a `Grantee` entity and all entities depending on
let grantee2, address1, address2;

grantee2 = await createGrantee(project);
address1 = await createAddress(grantee2);
address2 = await createAddress(grantee2);
await deleteGrantee(grantee2, { withChildren: true });
```
