Criar Documento

Faz upload de um arquivo para criar um novo documento no TapSign. O documento e criado dentro de um envelope em status DRAFT.

Requisicao

POST /v1/documents

Headers

Header	Tipo	Obrigatorio	Descricao
Authorization	string	Sim	Bearer token de autenticacao
Content-Type	string	Sim	multipart/form-data

Parametros (form-data)

Campo	Tipo	Obrigatorio	Descricao
file	file	Sim	Arquivo para upload (PDF, DOCX). Max 20MB
name	string	Nao	Nome do documento. Se omitido, usa o nome do arquivo

Exemplo de requisicao

curl -X POST \
  https://api.tapsign.com.br/v1/documents \
  -H "Authorization: Bearer {token}" \
  -F "file=@/caminho/para/contrato.pdf" \
  -F "name=Contrato de Prestacao de Servicos"

Resposta

201 - Criado com sucesso

{
  "id": "doc_7f8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
  "name": "Contrato de Prestacao de Servicos",
  "originalFilename": "contrato.pdf",
  "contentType": "application/pdf",
  "fileSize": 245780,
  "status": "DRAFT",
  "createdAt": "2026-03-29T10:15:30Z"
}

Campos da resposta

Campo	Tipo	Descricao
id	string	Identificador unico do documento
name	string	Nome do documento
originalFilename	string	Nome original do arquivo enviado
contentType	string	Tipo MIME do arquivo
fileSize	number	Tamanho do arquivo em bytes
status	string	Status do documento (DRAFT)
createdAt	string	Data de criacao (ISO 8601)

Dica

Apos criar o documento, voce pode adicionar signatarios e campos de assinatura antes de enviar para assinatura. O documento permanece em DRAFT ate ser enviado.

400 - Requisicao invalida

{
  "error": "BAD_REQUEST",
  "message": "O arquivo enviado nao e um formato suportado. Use PDF ou DOCX."
}

401 - Nao autorizado

{
  "error": "UNAUTHORIZED",
  "message": "Token de autenticacao invalido ou expirado."
}

413 - Arquivo muito grande

{
  "error": "PAYLOAD_TOO_LARGE",
  "message": "O arquivo excede o tamanho maximo permitido de 20MB."
}

Limite de tamanho

O tamanho maximo por arquivo e de 20MB. Para documentos maiores, considere comprimir o PDF antes do upload.

Formatos aceitos

Atualmente o TapSign aceita apenas arquivos PDF e DOCX. Outros formatos serao rejeitados com erro 400.