> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mettre à jour un document

> Mettez à jour le nom ou la description d'un document dans une base de connaissances Famulor via l'API. Gardez les documents sources de votre agent vocal IA organisés et étiquetés.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Ce point de terminaison met à jour les métadonnées d'un document existant. Vous ne pouvez modifier que le nom et la description : le type et le contenu du document ne peuvent pas être changés.

### Paramètres de chemin

<ParamField path="knowledgebaseId" type="integer" required>
  L'identifiant unique de la base de connaissances
</ParamField>

<ParamField path="documentId" type="integer" required>
  L'identifiant unique du document à mettre à jour
</ParamField>

### Corps de la requête

<ParamField body="name" type="string">
  Le nouveau nom du document (255 caractères maximum)
</ParamField>

<ParamField body="description" type="string">
  La nouvelle description du document (255 caractères maximum)
</ParamField>

### Champs de réponse

<ResponseField name="message" type="string">
  Message de succès
</ResponseField>

<ResponseField name="data" type="object">
  L'objet document mis à jour

  <Expandable title="Propriétés de data">
    <ResponseField name="id" type="integer">
      L'identifiant unique du document
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom du document
    </ResponseField>

    <ResponseField name="description" type="string">
      Description du document
    </ResponseField>

    <ResponseField name="type" type="string">
      Type de document
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Libellé de type lisible par un humain
    </ResponseField>

    <ResponseField name="status" type="string">
      Statut de traitement
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Libellé de statut lisible par un humain
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Horodatage ISO 8601 de la dernière mise à jour
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Pour mettre à jour le contenu d'un document, vous devez supprimer le document existant et en créer un nouveau avec le contenu mis à jour.
</Note>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "Document updated successfully.",
    "data": {
      "id": 1,
      "name": "Updated Product Handbook",
      "description": "Revised user manual with new features",
      "type": "pdf",
      "type_label": "PDF",
      "status": "active",
      "status_label": "Active",
      "updated_at": "2025-01-08T15:45:00.000000Z"
    }
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Knowledgebase not found."
  }
  ```

  ```json 404 Document Not Found theme={null}
  {
    "error": "Document not found."
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The name may not be greater than 255 characters.",
    "errors": {
      "name": [
        "The name may not be greater than 255 characters."
      ]
    }
  }
  ```
</ResponseExample>

<Tip>
  Voir aussi : [Introduction](/fr/api-v1/introduction) et [Guide d'authentification](/fr/api-v1/authentication), et [Exemples d'intégration API](/fr/api-v1/introduction).
</Tip>