---
title: "Upgrade de assinatura CMS/CAdES"
method: POST
path: "/cms/v1/upgrade/signature"
tags: ["Completadores"]
---

# Upgrade de assinatura CMS/CAdES

`POST /cms/v1/upgrade/signature`

## Request

- Base URL: `https://cloud-hom.bry.com.br`
- URL: `https://cloud-hom.bry.com.br/cms/v1/upgrade/signature`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/docs/cms/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: Assinatura PKCS7 (.p7s) com o documento anexado (attached). 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 (para assinaturas CMS) ou ADRT (para assinaturas CAdES ICP-Brasil). [Valores disponíveis: CMS: TIMESTAMP, CHAIN_CRL, COMPLETE e CAdES ICP-Brasil: ADRT, ADRV, ADRC, ADRA].
  - `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].

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