Atualizar Signatario

Atualiza os dados de um signatario existente em um envelope. Apenas os campos enviados serao alterados -- campos omitidos permanecem com os valores atuais.

Endpoint

PUT /v1/envelopes/{id}/signers/{signerId}

Headers

Header	Valor
Authorization	Bearer {token}
Content-Type	application/json

Parametros de URL

Parametro	Tipo	Obrigatorio	Descricao
id	string (UUID)	Sim	ID do envelope
signerId	string (UUID)	Sim	ID do signatario

Body

Todos os campos sao opcionais. Envie apenas os que deseja alterar.

Campo	Tipo	Descricao
name	string	Nome completo do signatario
email	string	Email do signatario
role	string	Papel: SIGNER, WITNESS, APPROVER, CARBON_COPY
phone	string	Telefone com DDD (ex: +5511999999999)

Restricao importante

Signatarios so podem ser atualizados enquanto o envelope estiver no status DRAFT. Apos o envio do envelope, os dados do signatario ficam bloqueados para garantir a integridade do processo de assinatura.

Exemplo de Requisicao

curl -X PUT https://api.tapsign.com.br/v1/envelopes/a1b2c3d4-e5f6-7890-abcd-ef1234567890/signers/f7e6d5c4-b3a2-1098-7654-321fedcba098 \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Joao Pedro da Silva",
    "email": "joao.pedro@empresa.com.br"
  }'

Resposta de Sucesso

Status: 200 OK

{
  "id": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "name": "Joao Pedro da Silva",
  "email": "joao.pedro@empresa.com.br",
  "role": "SIGNER",
  "phone": "+5511999999999",
  "status": "PENDING",
  "token": "abc123def456",
  "signingUrl": "https://app.tapsign.com.br/sign/abc123def456",
  "createdAt": "2026-03-29T14:30:00Z",
  "updatedAt": "2026-03-29T15:00:00Z"
}

Erros

Codigo	Descricao
400	Formato invalido nos campos enviados
404	Envelope ou signatario nao encontrado
409	Envelope ja foi enviado -- signatario nao pode ser alterado
422	Email duplicado no mesmo envelope

Dica

Se voce precisa corrigir o email de um signatario apos o envio do envelope, cancele o envelope, crie um novo e adicione o signatario com os dados corretos.