Skip to main content
PATCH
Atualizar atributos da entidade

Visão geral

Atualiza somente attributes sem alterar outros campos do perfil. Dois modos: Os atributos são armazenados exatamente como enviados — objetos aninhados atuam como categorias e são retornados como enviados, igual a Atualizar entidade:
O merge é raso no primeiro nível: enviar um objeto de categoria (ex.: contact) substitui toda essa categoria. Chaves internas não incluídas são descartadas. Use replace para reescrever tudo.
Se a matriz atribuída inclui trigger entity_updated, as regras rodam após o patch (respeita skipRulesExecution e watchFields). Webhook entity.updated é emitido com changes.attributes.

Endpoint

Autenticação

Requer entities:edit (fallback legacy: entities:write).

Parâmetros de rota

string
required
UUID da entidade.

Body

object
required
Mapa de atributos. Armazenado exatamente como enviado: valores escalares/array na raiz ficam sem categoria; objetos aninhados atuam como categorias.
string
default:"merge"
merge — patch aditivo (padrão). replace — substituição completa.
boolean
Com true, omite execução de matrizes de risco após a atualização.

Resposta

Exemplos

Merge (padrão)

Chaves existentes não enviadas permanecem inalteradas.

Substituição total

Chaves que existiam e não estão em attributes são removidas.

Erros