Aplicar etiqueta ao envelope

Sandbox

POST

/v4/api/envelopes/{envelopeId}/tags

Aplica uma etiqueta da conta. Reaplicar uma que já está aplicada não muda nada. O limite é de 3 etiquetas: a quarta responde 409 ENVELOPE_TAG_LIMIT. Etiqueta ou recurso inexistente, de outra conta ou fora da visibilidade responde 404. Exige o cabeçalho Idempotency-Key.

Requisição

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢204Sem Conteúdo

Sem conteúdo

Headers

Esta resposta não possui corpo.

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

🟠404Registo Não Encontrado

🟠409

🟠422Erro de Parâmetro

🟠429

🔴503Serviço Indisponível

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v4/api/envelopes//tags' \
--header 'Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "tagId": "string"
}'

Response Example

400 - Idempotency-Key ausente

{
    "error": {
        "code": "IDEMPOTENCY_KEY_REQUIRED",
        "message": "Idempotency-Key header is required"
    }
}

Modificado em 2026-09-29 13:02:20

Página anterior

Relatório de uso por grupo

Próxima página

Remover etiqueta do envelope