---
title: "Upgrade de assinatura PDF/PAdES. Pode ser utilizado somente em documentos com apenas UMA assinatura."
method: POST
path: "/pdf/v1/upgrade/signature"
tags: ["Completadores"]
---

# Upgrade de assinatura PDF/PAdES. Pode ser utilizado somente em documentos com apenas UMA assinatura.

`POST /pdf/v1/upgrade/signature`

## Request

- Base URL: `https://cloud-hom.bry.com.br`
- URL: `https://cloud-hom.bry.com.br/pdf/v1/upgrade/signature`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/docs/pdf/v1/upgrade/signature/post.ts> (a function with typed inputs; its response is checked against the schema)

Somente é possível completar a assinatura com carimbo do tempo caso o certificado do signatário não esteja expirado.

## Request body `multipart/form-data`

- object
  - `signature[0]` string, binary, required: Documento contendo a assinatura. Para lotes, basta incrementar o valor do índice, por ex: signature[0], signature[1]
  - `profile` string, required: Define o perfil que a assinatura terá após completa-lá. Para adição de carimbo do tempo, utilize o perfil TIMESTAMP ou ADRT (para assinaturas ICP-Brasil). [Valores disponíveis: TIMESTAMP, COMPLETE, ETSI_T, ETSI_LT e ICP-Brasil: ADRT, ADRC].
  - `replaceTimestamp` boolean: Opção para permitir a substituição dos carimbos do tempo da assinatura. É necessário que a substituição dos carimbos seja feita antes do certificado do signatário expirar definitivamente para que passem a constar como válidos ao serem verificados. [Valores disponíveis: true ou false / Default: false].
  - `returnType` string: Define o tipo de retorno da requisição. LINK retorna um link para download de cada arquivo assinado na resposta JSON. BASE64 retorna o arquivo assinado, codificado em Base64. Caso LINK, o arquivo será excluído da cache após o download. [Valores disponíveis: LINK ou BASE64 / Default: LINK].
  - `senhasDecifragem[0]` string: Array de strings com as senhas para decifragem dos documentos cifrados enviados no lote. Deve haver uma senha para cada documento do lote remetido, que será usada na decifragem do documento no respectivo índice do lote de documentos. Exemplo: '123456'

## Response `200`

The upgrade response.

- object[]
  - `status` integer
  - `timestamp` integer
  - `documentName` string
  - `message` string
  - `chave` string
  - `document` string
  - `link` object
    - `rel` string
    - `href` string: Link para recuperar documento assinado se tipoRetorno igual a LINK (o arquivo será excluído após o download)

## Other responses

- `400`: Resposta de erro da aplicação
- `default`: Para mais detalhes sobre as Respostas: [link para as respostas de erro](/openapi/completadores.html) ou [no formato properties](/openapi/completadoresErrors.properties)

---

[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)