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

# Atualizar documento

> Atualizar o nome ou descrição de um documento

Este endpoint atualiza os metadados de um documento existente. Você só pode atualizar o nome e a descrição - o tipo e conteúdo do documento não podem ser alterados.

### Parâmetros do Caminho

<ParamField path="knowledgebaseId" type="integer" required>
  O identificador único da base de conhecimento
</ParamField>

<ParamField path="documentId" type="integer" required>
  O identificador único do documento a ser atualizado
</ParamField>

### Corpo da Requisição

<ParamField body="name" type="string">
  O novo nome para o documento (máx. 255 caracteres)
</ParamField>

<ParamField body="description" type="string">
  A nova descrição para o documento (máx. 255 caracteres)
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseField name="data" type="object">
  O objeto documento atualizado

  <Expandable title="propriedades de data">
    <ResponseField name="id" type="integer">
      O identificador único do documento
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome do documento
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição do documento
    </ResponseField>

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

    <ResponseField name="type_label" type="string">
      Rótulo do tipo legível por humanos
    </ResponseField>

    <ResponseField name="status" type="string">
      Status de processamento
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Rótulo do status legível por humanos
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp ISO 8601 da última atualização
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "message": "Documento atualizado com sucesso.",
    "data": {
      "id": 1,
      "name": "Manual do Produto Atualizado",
      "description": "Guia do usuário revisado com novas funcionalidades",
      "type": "pdf",
      "type_label": "PDF",
      "status": "active",
      "status_label": "Ativo",
      "updated_at": "2025-01-08T15:45:00.000000Z"
    }
  }
  ```

  ```json 404 Knowledgebase Not Found theme={null}
  {
    "error": "Base de conhecimento não encontrada."
  }
  ```

  ```json 404 Document Not Found theme={null}
  {
    "error": "Documento não encontrado."
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "O nome não pode ter mais de 255 caracteres.",
    "errors": {
      "name": [
        "O nome não pode ter mais de 255 caracteres."
      ]
    }
  }
  ```
</ResponseExample>

<Note>
  Para atualizar o conteúdo de um documento, você precisa excluir o documento existente e criar um novo com o conteúdo atualizado.
</Note>