Mettre à jour le bloc de contenu
/content_blocks/update
Utilisez cet endpoint pour mettre à jour un bloc de contenu.
Les messages qui intègrent le bloc de contenu au moyen d’une étiquette Liquid utilisent la version mise à jour lors de leur prochain envoi. Pour plus d’informations, consultez Quand les modifications d’un bloc de contenu s’appliquent.

Vous pouvez également appeler cet endpoint via le serveur MCP de Braze en utilisant la fonction update_content_block. Cela permet à des outils d’IA comme Claude et Cursor de mettre à jour des blocs de contenu à l’aide de requêtes en langage naturel.
Prérequis
Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation content_blocks.update.
Limite de débit
La limite de débit par défaut de Braze, soit 250 000 requêtes par heure, s’applique à cet endpoint, comme indiqué dans Limites de débit de l’API.
Corps de la requête
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
}
Paramètres de requête
| Paramètre | Requis | Type de données | Description |
|---|---|---|---|
content_block_id |
Requis | Chaîne de caractères | L’identifiant API de votre bloc de contenu. |
name |
Facultatif | Chaîne de caractères | Nom du bloc de contenu. Doit contenir moins de 100 caractères. |
description |
Facultatif | Chaîne de caractères | Description du bloc de contenu. Doit contenir moins de 250 caractères. |
content |
Facultatif | Chaîne de caractères | Contenu HTML ou texte du bloc de contenu. |
state |
Facultatif | Chaîne de caractères | Choisissez active ou draft. Défini par défaut sur active si non spécifié. |
tags |
Facultatif | Tableau de chaînes de caractères | Les tags doivent déjà exister. |
Exemple de requête
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"]
}'
Réponse
{
"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"
}
Résolution des problèmes
Le tableau suivant répertorie les erreurs susceptibles d’être renvoyées et les étapes de résolution associées.
| Erreur | Résolution des problèmes |
|---|---|
Content cannot be blank |
|
Content must be a string |
Assurez-vous que votre contenu est encadré par des guillemets (""). |
Content must be smaller than 50kb |
Le contenu de votre bloc de contenu ne doit pas dépasser 50 Ko au total. |
Content contains malformed liquid |
Le Liquid fourni n’est pas valide ou ne peut pas être analysé. Réessayez avec du Liquid valide ou contactez l’assistance. |
Content Block cannot be referenced within itself |
|
Content Block description cannot be blank |
|
Content Block description must be a string |
Assurez-vous que la description de votre bloc de contenu est encadrée par des guillemets (""). |
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 |
Les noms de bloc de contenu peuvent comprendre les caractères suivants : les lettres (majuscules ou minuscules) de A à Z, les chiffres de 0 à 9, les tirets - et les traits de soulignement _. Ils ne peuvent pas contenir de caractères non alphanumériques comme des émojis, !, @, ~, & ou d’autres caractères « spéciaux ». |
Content Block with this name already exists |
Essayez un autre nom. |
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 |
Les tags doivent être un tableau de chaînes de caractères, par exemple ["marketing", "promotional", "transactional"]. |
All tags must be strings |
Assurez-vous que vos tags sont encadrés par des guillemets (""). |
Some tags could not be found |
Pour ajouter un tag lors de la création d’un bloc de contenu, le tag doit déjà exister dans Braze. |