Passer au contenu principal
Met à jour une activité existante — principalement pour clôturer un rappel traité depuis votre outil, afin qu’il cesse de remonter dans les relances du négociateur.
POST Activity crée l’activité et peut la programmer (deadline) ou la consigner comme déjà faite (completionDate). Cette route ferme la boucle : le rappel programmé hier est soldé aujourd’hui, sans ressaisie dans Avest.

Endpoint

URL : /external-integration/activity/{activityId} Méthode : PATCH Authentification : token LinkedAPI avec scope externalIntegration en écriture. Clé requise : lecture-écriture. Une clé en lecture seule reçoit 403. Voir Types de clé.

Path Parameters

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

Body Parameters

Au moins un champ.

Clôturer un rappel

La clôture produit les mêmes effets que depuis l’interface, dont les séquences branchées sur la clôture d’activité.
Renvoyer une completionDate sur une activité déjà close met simplement la date à jour, sans rejouer ces effets. Un rejeu de votre côté est donc sans conséquence : la route est sûre à relancer.

Rouvrir une activité

L’activité redevient « à faire » et retrouve sa place dans les relances, avec son échéance d’origine.

Corriger le texte d’une note

content remplace le texte de la note en entier. Il suit la même mise en forme qu’à la création : texte brut (les lignes vides deviennent des paragraphes) ou HTML.
content n’est accepté que sur une activité de type note. Sur une tâche, un appel ou tout autre type, la requête est refusée et rien n’est écrit.
Pour supprimer une note, voir DELETE Activity.

Attribution

owner désigne le collaborateur qui a réellement traité l’activité — celui qui a passé l’appel. Récupérez son ObjectId via GET Users.
L’owner fourni doit appartenir aux agences de votre clé et, sur une vente, à l’agence de la vente. Sinon la requête est refusée (400) et rien n’est écrit : owner is not in the authorized scope of this LinkedAPI ou Activity's sale owner not found. GET /users ne renvoie pas les agences d’un collaborateur : en cas de doute, omettez owner.

Périmètre

Les types modifiables sont ceux que vous pouvez créer : note, task, call, message, email, meeting, appointment.
Les activités système (changement d’étape, séquence, commandes) sont de l’historique et ne sont pas modifiables. Les visites et offres de match gardent leurs routes dédiées — voir Visites & offres —, car les clôturer pilote l’étape du match.
L’activité 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
L’objet activity a la même forme qu’à la création et qu’en lecture.

Réponses d’erreur

Rate limits

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