curl --request PATCH \
--url https://api.avest.fr/v1/external-integration/activity/{activityId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"completionDate": "2026-08-12T10:32:00.000Z",
"reason": "Répondu"
}
'{
"success": true,
"activity": {
"id": "6a04a0aed4948142783f8ce0",
"type": "call",
"startAt": null,
"endAt": null,
"deadline": "2026-08-12T09:00:00.000Z",
"completionDate": "2026-08-12T10:32:00.000Z",
"pinned": false,
"owner": "6939530d9200187f19a2707d",
"linkedDocument": "6a04a0aed4948142783f8cdf",
"linkedModel": "sale",
"data": {
"title": "Rappeler M. Dupont",
"content": "Relance après estimation.",
"reason": "Répondu"
},
"file": null,
"driveLinks": [],
"createdAt": "2026-08-04T10:00:00.000Z",
"updatedAt": "2026-08-12T10:32:00.000Z"
}
}Clôturer, rouvrir une activité ou corriger une note
Met à jour une activité existante — principalement pour clôturer un rappel honoré depuis un outil tiers, afin qu’il cesse de remonter dans les relances du négociateur.
completionDate accepte une date ISO 8601 pour clôturer, ou null pour rouvrir. reason consigne le résultat de l’action (le champ que l’interface Avest renseigne pour un appel). owner réattribue l’activité au collaborateur qui l’a réellement traitée. content remplace le texte d’une note (et uniquement d’une note), avec la même mise en forme qu’à la création.
Clôturer déclenche 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 est donc sans conséquence.
Périmètre : les mêmes types que POST /external-integration/activity (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, car les clôturer pilote l’étape du match.
curl --request PATCH \
--url https://api.avest.fr/v1/external-integration/activity/{activityId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"completionDate": "2026-08-12T10:32:00.000Z",
"reason": "Répondu"
}
'{
"success": true,
"activity": {
"id": "6a04a0aed4948142783f8ce0",
"type": "call",
"startAt": null,
"endAt": null,
"deadline": "2026-08-12T09:00:00.000Z",
"completionDate": "2026-08-12T10:32:00.000Z",
"pinned": false,
"owner": "6939530d9200187f19a2707d",
"linkedDocument": "6a04a0aed4948142783f8cdf",
"linkedModel": "sale",
"data": {
"title": "Rappeler M. Dupont",
"content": "Relance après estimation.",
"reason": "Répondu"
},
"file": null,
"driveLinks": [],
"createdAt": "2026-08-04T10:00:00.000Z",
"updatedAt": "2026-08-12T10:32:00.000Z"
}
}Autorisations
Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.
La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.
Paramètres de chemin
Corps
Au moins un champ parmi completionDate, reason, content et owner.
Collaborateur ayant réellement traité l'activité. 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.
^[a-fA-F0-9]{24}$"618a35a36d932054e195ca0a"