> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Inserir novo arquivo

> Insere um novo arquivo no processo de assinatura. O conteúdo pode ser enviado via base64 ou via URL.

## Path Parameters

<ParamField path="signature_process" type="string" required>
  UUID do processo de assinatura. **Exemplo**:
  `a2e9cbf7-442e-4c03-a353-5e58c53d1d1f`
</ParamField>

## Body Parameters

<ParamField body="filename" type="string" required>
  Nome do arquivo. **Exemplo**: `contrato.pdf`
</ParamField>

<ParamField body="extension" type="string" required>
  Extensão do arquivo. **Exemplo**: `pdf`
</ParamField>

<ParamField body="code" type="string">
  Código do arquivo. **Exemplo**: `ARQ001`
</ParamField>

<ParamField body="content" type="string">
  Conteúdo do arquivo em Base64. **Exemplo**: `JVBERi0xLjQKJcTl8uXrp/Og0MTGC...`
</ParamField>

<ParamField body="url" type="string">
  URL do arquivo para download. **Exemplo**: `https://exemplo.com/arquivo.pdf`
</ParamField>

<ParamField body="signers_uuids" type="array">
  Lista de UUIDs dos signatários associados a este arquivo.
</ParamField>

## Response

<ResponseField name="message" type="string">
  Mensagem de sucesso. **Exemplo**: `Arquivo inserido com sucesso.`
</ResponseField>

<ResponseField name="code" type="string">
  Código do arquivo. **Exemplo**: `ARQ001`
</ResponseField>

<ResponseField name="uuid" type="string">
  UUID do arquivo criado. **Exemplo**: `fa17f9e4-5555-41c3-8b69-e7e9b71cf3c4`
</ResponseField>

<ResponseField name="type" type="integer">
  Tipo do arquivo. **Exemplo**: `1`
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={"theme":"catppuccin-latte"}
  {
    "message": "Arquivo inserido com sucesso.",
    "code": "ARQ001",
    "uuid": "fa17f9e4-5555-41c3-8b69-e7e9b71cf3c4",
    "type": 1
  }
  ```

  ```json 401 Não autenticado theme={"theme":"catppuccin-latte"}
  ```

  ```json 403 Não autorizado theme={"theme":"catppuccin-latte"}
  ```

  ```json 422 Erro de validação theme={"theme":"catppuccin-latte"}
  ```

  ```json 500 Internal Server Error theme={"theme":"catppuccin-latte"}
  ```
</ResponseExample>