# Mettre à jour une donnée

Modifier une données existante dans une Collection.

{% hint style="success" %}

### 👍Url de la requête

Dans l'URL de la requête, vous devez remplacer **{$oid}** par l'**$oid** de la donnée à éditer
{% endhint %}

### Requête 

{% code overflow="wrap" lineNumbers="true" %}

```bash
curl --request PUT \
     --url https://api.getkis.io/api/v1/api_token_access/data_handlers/{$oid} \
     --header 'Authorization: Bearer ...' \
     --header 'accept: text/plain' \
     --header 'content-type: application/json' \
     --data '
{
     "data_handler": {
          "collection_name": "voitures",
    			"documents": [
          	{
          		"_id": "633f0bce07a52b302d298c88",
              "localisation": "toulouse",
              "stock": 812
           }
         ]
     }
}
```

{% endcode %}

### Paramètre

| Paramètre         | Type          | Description                                                           | Obligatoire ? |
| ----------------- | ------------- | --------------------------------------------------------------------- | ------------- |
| `collection_name` | String        | Nom de la table de données                                            | Oui           |
| `documents`       | Array d'objet | Array d'Objet contenant les champs et valeurs de la donnée à modifier | Oui           |

{% hint style="info" %}

### 📘Information

Dans le champs `documents` vous devez respecter l'orthographe des champs créés dans la structure de votre table de données. Vous n'êtes pas obligé de renseigner tous les champs de la structure de votre table de données. Vous devez aussi renseigner l' `_id`de la données à modifier.
{% endhint %}

{% hint style="danger" %}

### ❗️Attention

Si dans le champs `documents` vous renseignez un champs qui ne correspond pas à un existant dans la structure de votre table de données, la requête n'aboutira pas.

Le champs `documents` ne doit contenir qu'un seul objet.
{% endhint %}