Atualizar bloco de conteúdo
/content_blocks/update
Use esse endpoint para atualizar um bloco de conteúdo.
As mensagens que incluem o bloco de conteúdo com uma Liquid tag usam a versão atualizada no próximo envio. Para saber mais, consulte Quando as edições do bloco de conteúdo são aplicadas.

Você também pode chamar esse endpoint por meio do servidor MCP da Braze usando a função update_content_block. Isso permite que ferramentas de IA como Claude e Cursor atualizem blocos de conteúdo por meio de prompts em linguagem natural.
Pré-requisitos
Para usar esse endpoint, você precisará de uma chave de API com a permissão content_blocks.update.
Limite de frequência
Aplicamos o limite de frequência padrão da Braze de 250.000 solicitações por hora a esse endpoint, conforme documentado em Limites de frequência da API.
Corpo da solicitação
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
"content_block_id" : (required, string) Content Block's API identifier.
"name": (optional, string) Must be less than 100 characters,
"description": (optional, string) The description of the Content Block. Must be less than 250 character,
"content": (optional, string) HTML or text content within Content Block,
"state": (optional, string) Choose `active` or `draft`. Defaults to `active` if not specified,
"tags": (optional, array of strings) Tags must already exist
}
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo de dados | Descrição |
|---|---|---|---|
content_block_id |
Obrigatório | String | O identificador de API do seu bloco de conteúdo. |
name |
Opcional | String | Nome do bloco de conteúdo. Deve ter menos de 100 caracteres. |
description |
Opcional | String | Descrição do bloco de conteúdo. Deve ter menos de 250 caracteres. |
content |
Opcional | String | Conteúdo HTML ou de texto no bloco de conteúdo. |
state |
Opcional | String | Escolha active ou draft. O padrão é active se não for especificado. |
tags |
Opcional | Matriz de strings | As tags já precisam existir. |
Exemplo de solicitação
curl --location --request POST 'https://rest.iad-01.braze.com/content_blocks/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
"content_block_id" :"content_block_id",
"name": "content_block",
"description": "This is my Content Block",
"content": "HTML or text content within block",
"state": "draft",
"tags": ["marketing"]
}'
Resposta
{
"content_block_id": (string) Your newly generated block id,
"liquid_tag": (string) The generated block tag from the Content Block name,
"created_at": (string) The time the Content Block was created in ISO 8601,
"message": "success"
}
Solução de problemas
A tabela a seguir lista os possíveis erros retornados e as etapas de solução de problemas associadas.
| Erro | Solução de problemas |
|---|---|
Content cannot be blank |
|
Content must be a string |
Confira se o seu conteúdo está entre aspas (""). |
Content must be smaller than 50kb |
O conteúdo do seu bloco de conteúdo deve ter menos de 50 KB no total. |
Content contains malformed liquid |
O Liquid fornecido não é válido ou não pode ser analisado. Tente novamente com um Liquid válido ou entre em contato com o suporte. |
Content Block cannot be referenced within itself |
|
Content Block description cannot be blank |
|
Content Block description must be a string |
Confira se a descrição do bloco de conteúdo está entre aspas (""). |
Content Block description must be shorter than 250 characters |
|
Content Block name cannot be blank |
|
Content Block name must be shorter than 100 characters |
|
Content Block name can only contain alphanumeric characters |
Os nomes dos blocos de conteúdo podem incluir qualquer um dos seguintes caracteres: as letras (maiúsculas ou minúsculas) de A a Z, os números de 0 a 9, hifens - e sublinhados _. Eles não podem conter caracteres não alfanuméricos, como emojis, !, @, ~, & e outros caracteres “especiais”. |
Content Block with this name already exists |
Tente um nome diferente. |
Content Block name cannot be updated for active Content Blocks |
|
Content Block state must be either active or draft |
|
Active Content Block can not be updated to Draft. Create a new Content Block. |
|
Tags must be an array |
As tags devem ser formatadas como uma matriz de strings, por exemplo, ["marketing", "promotional", "transactional"]. |
All tags must be strings |
Confira se as tags estão entre aspas (""). |
Some tags could not be found |
Para adicionar uma tag ao criar um bloco de conteúdo, a tag já precisa existir na Braze. |