---
title: "PUT Update request signing chain"
method: PUT
path: "/api/requests/chain/update"
---

# PUT Update request signing chain

`PUT /api/requests/chain/update`

## Request

- Base URL: `https://app.plugsign.com.br`
- URL: `https://app.plugsign.com.br/api/requests/chain/update`
- Auth: API key in header `Authorization`

Edita a cadeia de signatários de uma solicitação **pendente e encadeada** (enviada com `chain: true`). As operações são executadas na ordem enviada: `update` troca o e-mail de um signatário, `remove` retira um signatário, `add` insere um novo signatário (com seus campos) e `update_additional_info` altera nome, CPF ou data de nascimento.

Solicitações não encadeadas, não pendentes ou de outra empresa respondem `404`; operações inválidas (e-mail fora da cadeia, por exemplo) respondem `422`.

## Request body

- object
  - `signing_key` string, required: Chave da solicitação de assinatura que será atualizada.
  - `operations` object[], required: Uma ou mais operações, executadas na ordem enviada.
    - `action` 'update' | 'remove' | 'add' | 'update_additional_info', required: Ação.
    - `target_email` string: E-mail do signatário. Obrigatório em update, remove e update_additional_info.
    - `new_email` string: Novo e-mail. Obrigatório em update e add; opcional em update_additional_info.
    - `after_email` string: Insere após o e-mail indicado, ou use beginning ou last.
    - `fullname` string: Nome completo do novo signatário.
    - `cpf` string: CPF do novo signatário.
    - `birthdate` string: Data de nascimento do novo signatário.
    - `message` string: Mensagem personalizada para o novo signatário.
    - `subject` string: Assunto da comunicação enviada ao novo signatário.
    - `allow_selfie` boolean: Define se será permitido solicitar uma selfie.
    - `allow_document` boolean: Define se será permitido solicitar o documento (frente).
    - `allow_document_back` boolean: Define se será permitido solicitar o verso do documento.
    - `allow_cpf` boolean: Define se o CPF será exigido. Padrão: true.
    - `allow_birth_date` boolean: Define se a data de nascimento será exigida. Padrão: true.
    - `signature_type` string: Tipo de assinatura do novo signatário.
    - `signature_mode` string: Modo de assinatura: all, draw, text ou upload.
    - `doubleauth` boolean: Define se será usada autenticação dupla.
    - `certificate` integer: Código de certificado associado ao signatário.
    - `send_finished` boolean: Define a configuração de envio ao finalizar.
    - `expire_date` string: Data de expiração no formato YYYY-MM-DD; deve ser futura.
    - `fields` object[]: Lista de campos posicionados no documento. Usada somente quando action é add.
      - `type` string, required: Tipo do campo: signature, text ou rubric.
      - `page` integer: Página do documento. Informe para signature e text; para rubric, a API usa a página 0.
      - `xPos` number, required: Posição horizontal do campo no documento.
      - `yPos` number, required: Posição vertical do campo no documento.
      - `width` number, required: Largura do campo.
      - `height` number, required: Altura do campo.
      - `text` string: Texto a exibir no campo text.
      - `fontsize` number: Tamanho da fonte. O padrão é 14 para campos text com text informado.
      - `color` string: Cor do texto; o padrão é #000000 para campos text com text informado.
      - `align` string: Alinhamento do texto: left, center ou right.
      - `bold` string: Configuração de negrito para o texto.
      - `italic` string: Configuração de itálico para o texto.
      - `underline` string: Configuração de sublinhado para o texto.
      - `strikethrough` string: Configuração de tachado para o texto.
      - `default` string: Valor padrão do campo de texto.
      - `validateData` boolean: Define se os dados do campo devem ser validados.

## Response `200`

Cadeia de assinatura atualizada com sucesso.

- object
  - `message` string: Confirma que a cadeia foi atualizada.
  - `chain_emails` string[]: E-mails dos signatários na cadeia após as operações.
  - `warnings` string[]: Avisos (textos) gerados durante o processamento; lista vazia quando não há avisos.

## Other responses

- `404`: Not Found
- `422`: Unprocessable Entity

## Changes

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

[Operation history](https://skmtc.dev/plugsign/apis/endpoints-manuais/changes/api/requests/chain/update/put.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)