API

Atualizar uma audiência

Uma atualização parcial. Um campo que omita mantém o valor guardado e um `null` explícito limpa-o. A audiência predefinida integrada pode ser renomeada e descrita como qualquer outra, e renomeá-la não altera nem `builtin` nem o que ela contém.

PATCHapi.openemail.uk/audiences/{id}

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

PATCH /audiences/{id}

Uma atualização parcial. Um campo que omita mantém o valor guardado e um null explícito limpa-o. A audiência predefinida integrada pode ser renomeada e descrita como qualquer outra, e renomeá-la não altera nem builtin nem o que ela contém.

Exemplo

Requer audiences:write.

curl

curl -X PATCH "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Release notes"}'

Resposta

{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Release notes",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:22:00.000Z"}

builtin não pode ser definido, movido nem limpo a partir daqui.

Renomear não move ninguém. Os contactos permanecem na audiência com o nome novo, e o id nunca muda.