# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.kis.work/documentation/documentation-api/donnees-dune-table-de-donnees/mettre-a-jour-une-donnee.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.