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

# PATCH Activity

> Clôture un rappel honoré depuis votre outil, ou le rouvre — pour que les relances du négociateur restent à jour. Corrige aussi le texte d'une note.

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.

> [!NOTE]
>
> [POST Activity](https://developers.avest.fr/endpoints/post-activity.md) 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é](https://developers.avest.fr/guides/authentification.md).

## Path Parameters

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `activityId` | ObjectId | ✅ | ObjectId de l'activité. |

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

## Body Parameters

Au moins **un** champ.

| Champ | Type | Description |
| - | - | - |
| `completionDate` | String \| null | Date ISO 8601 de réalisation pour **clôturer**, `null` pour **rouvrir**. |
| `reason` | String | Résultat de l'action (faux numéro, non répondu, répondu…). Stocké dans `data.reason`. |
| `owner` | ObjectId | Collaborateur ayant réellement traité l'activité. |
| `content` | String | Nouveau texte d'une **note** (type `note` uniquement). Remplace `data.content`. |

## Clôturer un rappel

```bash theme={null}
curl -X PATCH "https://api.avest.fr/v1/external-integration/activity/6a04a0aed4948142783f8ce0" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "completionDate": "2026-08-12T10:32:00.000Z",
    "reason": "Répondu"
  }'
```

La clôture produit les **mêmes effets que depuis l'interface**, dont les séquences branchées sur la clôture d'activité.

> [!NOTE]
>
> 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é

```json theme={null}
{ "completionDate": null }
```

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

## Corriger le texte d'une note

```bash theme={null}
curl -X PATCH "https://api.avest.fr/v1/external-integration/activity/6a04a0aed4948142783f8ce0" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Visite du bien avec M. Martin.\n\nRappeler le 14/04 pour une offre."
  }'
```

`content` **remplace** le texte de la note en entier. Il suit la même [mise en forme](https://developers.avest.fr/endpoints/post-activity.md) qu'à la création : texte brut (les lignes vides deviennent des paragraphes) ou HTML.

> [!WARNING]
>
> `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](https://developers.avest.fr/endpoints/delete-activity.md).

## 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](https://developers.avest.fr/endpoints/get-users.md).

> [!WARNING]
>
> 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`.

> [!WARNING]
>
> 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](https://developers.avest.fr/endpoints/visits-offers.md)
> —, 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`

```json theme={null}
{
  "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"
  }
}
```

L'objet `activity` a la même forme qu'à la création et qu'en lecture.

## Réponses d'erreur

| Message | Cause |
| - | - |
| `ExternalIntegrationUpdateActivity : Invalid activityId` | Identifiant absent ou mal formé. |
| `ExternalIntegrationUpdateActivity : No editable field provided. Allowed: …` | Body vide. |
| `ExternalIntegrationUpdateActivity : Invalid completionDate` | Date non conforme à l'ISO 8601. |
| `ExternalIntegrationUpdateActivity : Unable to find activity` | Activité inexistante ou hors de votre périmètre. |
| `ExternalIntegrationUpdateActivity : This activity type cannot be updated through the API` | Activité système, visite ou offre de match. |
| `ExternalIntegrationUpdateActivity : owner is not in the authorized scope of this LinkedAPI` | `owner` hors des agences de la clé. |
| `ExternalIntegrationUpdateActivity : content must be a non-empty string` | `content` vide ou non textuel. |
| `ExternalIntegrationUpdateActivity : content can only be updated on a note activity` | `content` envoyé sur une activité qui n'est pas une note. |

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