---
title: "(Antigo) POST Upload and send request"
method: POST
path: "/api/files/upload/requestss"
---

# (Antigo) POST Upload and send request

`POST /api/files/upload/requestss`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/files/upload/requestss`
- Auth: API key in header `Authorization`

Faz o upload de um documento (PDF ou Office) e envia para ser assinado por uma ou mais pessoas com assinatura na página de validação.

Este endpoint chama os endpoints de "Upload File" e "Send Request With Document", portanto as regras de validação de ambos se aplicam a ele.

Portanto é possível enviar documentos BASE64 (PDF) no padrão aceito em "Upload File" por exemplo, assim como o sistema vai converter documentos de office no ato da solicitação, como em "Send Request With Document".

## Request body

- object
  - `folder` integer: ID da pasta onde o documento deve ser armazenado. Caso não seja informado, o documento ficará na pasta raiz da empresa.
  - `name` string, required: Nome do arquivo que será criado no sistema
  - `file` string, binary, required: File/Base64 Arquivo PDF ou office como arquivo, para PDF é possível enviar um Base644
  - `chain` boolean: Se a solicitação é em cadeia, ou seja, deve respeitar a ordem dos e-mails para envio ou se será enviada para todos ao mesmo tempo
  - `email` string[], required: E-mails e/ou Celulares com WhatsApp para envio, mínimo 1
  - `sender` string: Identifica o colaborador que aparecerá como remetente deste documento. Pode ser o ID do usuário ou o e-mail dele. Se omitido, o documento será enviado pela conta do admin da empresa.
  - `message` string: Mensagem enviada para o destinatário
  - `expire_date` string: Data de expiração para este destinatário. Deve ser uma data válida no formato Y-m-d e posterior à data atual.
  - `due_months` integer: A validade do documento em meses, por exemplo, um contrato com 12 meses de validade. Nós iremos monitorar a data e avisaremos antes do vencimento, para que possam refazer a solicitação e reenviar para assinatura
  - `observer` string[]: Os observadores irão receber comunicados referentes à situação da solicitação. Para isso, inclua uma lista de emails
  - `uploaded_by` integer: ID do usuário que enviou o documento
  - `signature_type` string: Tipo da assinatura (all, draw, text, upload)
  - `editablevalidate` integer: 1 - QR Code no topo do documento (Sem página final). <br><br> Ao solicitar a assinatura na última página, sem posicioná-la, a página final será sempre gerada automaticamente. <br><br> 2 - Sem QR Code no topo, apenas página no final. <br><br> 3 - Página final de validação e QR Code no cabeçalho (Criaremos páginas extras). <br><br> 4 - QR Code no rodapé do documento (Sem página final). <br><br> 5 - Página final de validação e QR Code no rodapé (Criaremos páginas extras). <br><br> 6 - QR Code (Texto) na lateral esquerda. <br><br> 7 - QR Code (Texto) na lateral direita. <br><br>
  - `optimizer` boolean: Marca o documento para otimização, caso enviado 1 o sistema irá otimizar e achatar campos de formulário no documento
  - `send_finished` boolean[]: Opção para indicar se o usuário deve receber o documento após todas as assinaturas serem concluídas. O array deve seguir a mesma ordem e quantidade dos e-mails. Por padrão, o valor é true. Esse campo é válido apenas quando o valor de 'chain' for 0 (false)
  - `silent_mode` boolean: Quando ativado (True), o request não gera um e-mail para o cliente. Apenas o URL de assinatura e o e-mail serão retornados
  - `reminders` string[]: E-mails e/ou Celulares para enviar lembrete. O array deve seguir a mesma ordem dos e-mails ou números de celular. O tamanho do array deve ser igual ou menor ao do array de e-mails/celulares. Este campo só funciona quando o valor de chain for 0 (false)
  - `doubleauth` boolean: Este campo especifica se será realizada uma autenticação adicional para confirmar a assinatura. Quando ativado, o sistema enviará um token de validação para o e-mail e/ou WhatsApp do usuário. O usuário deverá inserir o token recebido para concluir a assinatura. Este campo é válido apenas quando o valor de 'chain' for 0 (false) e se aplica a todos os assinantes da requisição
  - `request_image` string, json: Com este campo, você pode solicitar uma selfie, a parte da frente do documento de identidade ou de trás no momento da assinatura
  - `width_page` integer: Este campo se torna obrigatório quando o campo fields for definido.
  - `fields` string, json: Este campo deve ser um objeto de objetos, para cada e-mail passado no array emails, aqui deve ser passado um objeto com os campos de preenchimento e assinatura do usuário, na mesma ordem dos e-mails

## Response `200`

200

- object
  - `data` object: Objeto principal contendo os dados da solicitação de assinatura criada.
    - `id` integer: Identificador único da solicitação de assinatura.
    - `signing_key` string: Chave única de assinatura utilizada para autenticar e identificar a requisição.
    - `document` string: Identificador do documento a ser assinado.
    - `email` string: E-mail do signatário que receberá a solicitação de assinatura.
    - `message` string: Mensagem personalizada enviada ao signatário junto com a solicitação.
    - `sender` object: Remetente da solicitação.
      - `id` integer: Identificador único do remetente da solicitação.
      - `name` string: Primeiro nome do remetente.
      - `last_name` string: Sobrenome do remetente.
      - `email` string: E-mail do remetente.
      - `permissions` string[]: Lista de permissões do remetente na plataforma.
    - `expire_date` string: Data de expiração da solicitação.
    - `send_time` string: Data e hora em que a solicitação foi enviada.
    - `update_time` string: Data e hora da última atualização da solicitação.
    - `creted_at` string: Data e hora de criação da solicitação.
    - `status` string: Status atual da solicitação.
    - `observer` string[]: E-mail(s) de um observador da solicitação.
  - `message` string: Mensagem de confirmação retornada pela API após o envio da solicitação.

## Changes

- **2026-11-03** `3db1513040ea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/files/upload/requestss/post.md)

---

[API](https://skmtc.dev/plugsign/apis/endpoints-manuais.md) - [All operations](https://skmtc.dev/plugsign/apis/endpoints-manuais/llms.txt) - [OpenAPI document](https://skmtc.dev/plugsign/apis/endpoints-manuais/revisions/3db1513040ea?raw)