Passer au contenu principal
Supprime définitivement une activité de type note sur une fiche (acquéreur, vendeur, location ou contact).
Pour corriger le texte d’une note plutôt que de la supprimer, utilisez PATCH Activity 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é.

Path Parameters

L’id est renvoyé à la création par POST Activity et par GET Activities.

Exemple

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.
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é.

Périmètre

Seules les activités de type note sont supprimables.
Une tâche, un appel ou un rendez-vous porte des échéances et des séquences : ils se clôturent avec PATCH Activity (completionDate), ils ne se suppriment pas. Les visites et offres de match s’annulent via leurs routes dédiées — voir Visites & offres.
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

Réponses d’erreur

Une clé sans l’option suppression (lecture seule, ou lecture-écriture standard) reçoit 403 Not authorized to access this resource. Voir Authentification.

Rate limits

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