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

# Actualizar documento

> Actualiza el nombre o la descripción de un documento en una base de conocimiento de Famulor mediante la API. Mantén organizado y etiquetado el material fuente de tu agente de voz de IA.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint actualiza los metadatos de un documento existente. Solo puedes actualizar el nombre y la descripción: el tipo de documento y su contenido no se pueden cambiar.

### Parámetros de ruta

<ParamField path="knowledgebaseId" type="integer" required>
  El identificador único de la base de conocimiento
</ParamField>

<ParamField path="documentId" type="integer" required>
  El identificador único del documento a actualizar
</ParamField>

### Cuerpo de la solicitud

<ParamField body="name" type="string">
  El nuevo nombre del documento (máx. 255 caracteres)
</ParamField>

<ParamField body="description" type="string">
  La nueva descripción del documento (máx. 255 caracteres)
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito
</ResponseField>

<ResponseField name="data" type="object">
  El objeto del documento actualizado

  <Expandable title="Propiedades de los datos">
    <ResponseField name="id" type="integer">
      El identificador único del documento
    </ResponseField>

    <ResponseField name="name" type="string">
      El nombre del documento
    </ResponseField>

    <ResponseField name="description" type="string">
      Descripción del documento
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo de documento
    </ResponseField>

    <ResponseField name="type_label" type="string">
      Etiqueta de tipo legible para humanos
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado de procesamiento
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Etiqueta de estado legible para humanos
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Marca de tiempo ISO 8601 de la última actualización
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  Para actualizar el contenido de un documento, debes eliminar el documento existente y crear uno nuevo con el contenido actualizado.
</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>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>