---
title: "Inclusão de novos documentos para assinatura"
method: POST
path: "/api/service/sign/v1/signatures/{request_id}/documents"
tags: ["Gestão"]
---

# Inclusão de novos documentos para assinatura

`POST /api/service/sign/v1/signatures/{request_id}/documents`

## Request

- Base URL: `https://cloud-hom.bry.com.br`
- URL: `https://cloud-hom.bry.com.br/api/service/sign/v1/signatures/{request_id}/documents`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/docs/api/service/sign/v1/signatures/:request_id/documents/post.ts> (a function with typed inputs; its response is checked against the schema)

Efetua o upload e a inclusão de novos documentos para assinatura em um determinado envio de assinaturas que ainda não foi inicializada.

## Request body

- Document[]
  - `type` 'PDF' | 'CMS' | 'XML': Formato detectado do documento.
  - `name` string: Nome do documento.
  - `size` integer: Tamanho do documento em bytes.
  - `hash` Hash: Resumo criptográfico (hash)
    - `value` string: Valor do hash codificado em hexadecimal.
    - `algorithm` string: Algoritmo utilizado para o cálculo do hash.

## Response `200`

Retorno das informações relacionadas aos novos documentos adicionados ao envio

- DocumentResponse[]
  - `documentNonce` string: Valor nonce do documento, definido pelo usuário ou gerado pelo backend
  - `documentUuid` string: Valor UUID do documento, gerado pelo backend
  - `name` string: Nome do documento
  - `status` 'AVAILABLE' | 'DELETED': Status atual do documento. AVAILABLE - Documento está disponível; DELETED - Documento foi removido e não está mais disponível.
  - `deletion` string: Unix timestamp de deleção do documento, caso ele tenha sido removido.
  - `currentDocumentSize` number: Tamanho (em bytes) do documento contendo as assinaturas já realizadas.
  - `currentDocumentLink` object: Link de acesso com autenticação ao documento contendo as assinaturas já realizadas
    - `href` string
  - `originalDocumentLink` object: Link de acesso com autenticação ao documento original
    - `href` string

---

[API](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest.md) - [All operations](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/llms.txt) - [OpenAPI document](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/revisions/c87e026e87ac?raw)