> ## Documentation Index
> Fetch the complete documentation index at: https://developers.avest.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE Activity

> Supprime une note depuis votre outil — une note créée par erreur ne reste plus sur la fiche.

Supprime définitivement une activité de type **`note`** sur une fiche (acquéreur, vendeur, location ou contact).

> [!NOTE]
>
> Pour corriger le texte d'une note plutôt que de la supprimer, utilisez
> [PATCH Activity](https://developers.avest.fr/endpoints/patch-activity.md) avec `content`.

## Endpoint

**URL** : `/external-integration/activity/{activityId}`
**Méthode** : `DELETE`
**Authentification** : token LinkedAPI avec scope `externalIntegration`.
**Clé requise** : lecture-écriture + suppression, accordée sur demande. Toute autre clé reçoit `403`. Voir [Types de clé](https://developers.avest.fr/guides/authentification.md).

## Path Parameters

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `activityId` | ObjectId | ✅ | ObjectId de la note. |

L'`id` est renvoyé à la création par [POST Activity](https://developers.avest.fr/endpoints/post-activity.md) et par [GET Activities](https://developers.avest.fr/endpoints/get-activities.md).

## Exemple

```bash theme={null}
curl -X DELETE "https://api.avest.fr/v1/external-integration/activity/6a04a0aed4948142783f8ce0" \
  -H "Authorization: Bearer {token}"
```

La suppression produit les **mêmes effets que depuis l'interface** : la note disparaît de la fiche et de `GET /activities`. Les pièces jointes rattachées à la note restent sur la fiche, comme de simples fichiers.

> [!WARNING]
>
> La suppression est **définitive** : aucune corbeille, aucune restauration par
> l'API ou l'interface. Elle relève de **votre responsabilité** : Avest ne s'engage
> pas à restaurer les données supprimées, et une restauration acceptée pourra être
> **facturée**. Chaque appel est journalisé avec la clé qui l'a émis (clé, note
> visée, date, résultat). Voir [Types de clé](https://developers.avest.fr/guides/authentification.md).

## Périmètre

Seules les activités de type **`note`** sont supprimables.

> [!WARNING]
>
> Une tâche, un appel ou un rendez-vous porte des échéances et des séquences : ils
> se **clôturent** avec [PATCH Activity](https://developers.avest.fr/endpoints/patch-activity.md) (`completionDate`),
> ils ne se suppriment pas. Les **visites** et **offres** de match s'annulent via
> leurs routes dédiées — voir [Visites & offres](https://developers.avest.fr/endpoints/visits-offers.md).

La note doit appartenir au périmètre autorisé du token (`agencyGroup` + agences de la clé), sinon la requête répond « introuvable ».

## Réponse de succès

**Code** : `200`

```json theme={null}
{
  "success": true,
  "id": "6a04a0aed4948142783f8ce0"
}
```

## Réponses d'erreur

| Message | Cause |
| - | - |
| `ExternalIntegrationDeleteActivity : Invalid activityId` | Identifiant absent ou mal formé. |
| `ExternalIntegrationDeleteActivity : Unable to find activity` | Note inexistante, déjà supprimée ou hors de votre périmètre. |
| `ExternalIntegrationDeleteActivity : Only note activities can be deleted through the API` | Activité d'un autre type que `note`. |

Une clé sans l'option suppression (lecture seule, ou lecture-écriture standard) reçoit `403 Not authorized to access this resource`. Voir [Authentification](https://developers.avest.fr/guides/authentification.md).

## Rate limits

**100 req / minute par groupe d'agences** (bucket d'écriture).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.