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

# 📤 Cargar nuevo

> Permite cargar un documento a una tarea para que posteriormente pueda ser firmado o validado por los participantes configurados.

## <Badge color="yellow">POST</Badge>➜ /v2/tareas/tarea\_id/documentos

`https://api.contractia.app/v2/tareas/tarea_id/documentos`

<Info>
  Reemplazar `{tarea_id}` por el ID numérico de la tarea deseada.
</Info>

<Note>
  El documento debe cargarse en Base 64.
</Note>

### 🧾 Parámetros del cuerpo (JSON)

| **Parámetro**         | **Tipo** | **Descripción**                                |
| :-------------------- | :------- | :--------------------------------------------- |
| `subTipoDocumentalId` | string   | link a endpoint get subtipos documentales      |
| `referencia`          | string   | Nombre con el que se visualizará el documento. |
| `fileData`            | objeto   |                                                |
| `fileName`            | string   | Nombre original del documento.                 |
| `fileContentBase64`   | string   | Documento en Base 64.                          |

### 💻 Ejemplo de implementación

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl --location --request POST 'https://api.contractia.app/v2/tareas/{{tarea_id}}/documentos' \
    --header 'Authorization: Bearer {{api_key}}' \
    --header 'user_id: {{user_id}}' \
    --header 'Content-Type: application/json' \
    --data '{
        "codigo_sub_tipo_doc": "004",
        "referencia": "Formulario de afiliación",
        "file_data": {
            "file_name": "form.pdf",
            "file_content_base64": "pdf_base_64"
        }
    }'
    ```
  </Tab>

  <Tab title="Request JSON">
    ```json theme={null}
    {
        "codigo_sub_tipo_doc" : "004",
        "referencia" : "Formulario de afiliación",
        "file_data" : {
            "file_name" : "form.pdf",
            "file_content_base64":"pdf_base_64"
            
        }
    }
    ```
  </Tab>

  <Tab title="Response JSON">
    ```json theme={null}
    "d455f84e-abb3-4af2-9835-24242f118df9"
    ```
  </Tab>
</Tabs>

#### Siguiente paso:

* Iniciar una tarea [➜](/platform/iniciar)