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

> Corrige les critères de recherche d'une fiche acquéreur existante.

Met à jour les **critères de recherche** d'une acquisition existante : budget, surfaces, nombre de pièces, équipements, projet.

> [!NOTE]
>
> Jusqu'ici, corriger un budget imposait de re-poster la fiche via
> [POST Acquisition](https://developers.avest.fr/endpoints/post-acquisition.md) et d'espérer que la
> déduplication retombe sur la bonne. Cette route évite ce détour — et surtout,
> elle ne relance ni le routage, ni l'allocation, ni les alertes leadgen.

## Endpoint

**URL** : `/external-integration/acquisition/{acquisitionId}`
**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 |
| - | - | - | - |
| `acquisitionId` | ObjectId | ✅ | ObjectId de l'acquisition. |

## Body Parameters

Au moins **un** champ. Seuls les champs listés sont modifiables.

| Champ | Type | Description |
| - | - | - |
| `project` | String | Type de projet de l'acquéreur. |
| `activityLevel` | String | `hot`, `warm`, `cold` ou `mandate`. |
| `propertiesTypes` | Array\<String> | Types de biens recherchés. |
| `priceRange` | `{ low, high }` | Budget. |
| `sizeRange` | `{ low, high }` | Surface habitable. |
| `fieldRange` | `{ low, high }` | Surface de terrain. |
| `roomRange` | `{ low, high }` | Nombre de pièces. |
| `bedroomRange` | `{ low, high }` | Nombre de chambres. |
| `floorRange` | `{ low, high }` | Étage. |
| `elevator` | String | `essential`, `preferable`, `unnecessary` ou `excluded` (le bien ne doit pas en avoir). |
| `outdoor` | String | Idem. |
| `parking` | String | Idem. |
| `pool` | String | Idem. |
| `lastFloor` | String | Idem. |
| `groundFloor` | String | Idem. |
| `singleStorey` | String | Idem (plain-pied). |
| `bikeShed` | Boolean | Local vélo souhaité. |
| `mortgage` | Boolean | L'acquéreur finance par un crédit. |
| `purpose` | String | Destination du bien (`primaryResidence`…). |

> [!WARNING]
>
> **`step` n'est pas modifiable ici.** L'étape d'une fiche acquéreur passe par
> [POST Qualify](https://developers.avest.fr/endpoints/post-acquisition-qualify.md), qui applique les règles
> métier (fermeture de la séquence de relance, transition de la mise en
> relation d'origine). `customId`, `parsingCustomId`, `mandate`, `owner` et
> `agency` ne sont pas modifiables non plus.

> [!NOTE]
>
> **Les zones de recherche (`areas`) ne sont pas modifiables** par cette route.
> Si c'est un besoin de votre côté, remontez-le nous — nous préférons ne pas
> accepter un champ que nous n'appliquerions pas.

## Exemple

```bash theme={null}
curl -X PATCH "https://api.avest.fr/v1/external-integration/acquisition/619b46b47e043165f206db1c" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "priceRange": { "low": 200000, "high": 320000 },
    "bedroomRange": { "low": 2, "high": 4 },
    "activityLevel": "hot"
  }'
```

La réponse renvoie l'acquisition au format public, identique à [GET Acquisition](https://developers.avest.fr/endpoints/get-acquisition.md).

## Concurrence

Si la fiche est modifiée simultanément par un agent, la requête est rejouée automatiquement. En cas d'échec persistant, la réponse est `409` avec le code `TRANSACTION_EDIT_CONFLICT` — rejouez la requête.

## Réponses d'erreur

| Message | Cause |
| - | - |
| `ExternalIntegrationUpdateAcquisition : Invalid acquisitionId` | ObjectId invalide. |
| `ExternalIntegrationUpdateAcquisition : No editable field provided. Allowed: …` | Body vide, ou uniquement des champs non modifiables. |
| `ExternalIntegrationUpdateAcquisition : Unable to find acquisition` | Fiche inexistante ou hors de votre périmètre. |

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