Update Content Block

Use this endpoint below to update an Email Content Block.

Request Body

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
4
5
6
7
8
{
  "content_block_id" :"123a45b6-cd78-9e01-g234-hi56j7k8l9m0", 
  "name": "content-block-1",
  "description": "This is my content block",
  "content": "HTML or text content within block",
  "state": "draft",
  "tags": ["",""]
}

Request Parameters

Example Request

1
2
3
4
5
6
7
8
9
10
11
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" :"123a45b6-cd78-9e01-g234-hi56j7k8l9m0", 
  "name": "content-block-1",
  "description": "This is my content block",
  "content": "HTML or text content within block",
  "state": "draft",
  "tags": ["",""]
}'

Successful Response Properties

1
2
3
4
5
6
7
8
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
  "content_block_id": "newly-generated-block-id",
  "liquid_tag": "generated-block-tag-from-content_block_name",
  "created_at": "time-created-in-iso",
  "message": "success"
}

Possible Errors

• Content cannot be blank.

• Content must be a string.

• Content must be smaller than 50kb. - The content in your content block must be less than 50kb total.

• Content contains malformed liquid. - The liquid provided is not valid or parsable. Please try again or reach out to support.

• Content Block cannot be referenced within itself.

• Content Block description cannot be blank.

• Content Block description must be a string.

• Content block description must be shorter than 250 characters. - Your content block description must be less than 250 characters.

• Content Block name cannot be blank.

• Content Block name must be a shorter than 100 characters.

• Content Block name can only contain alphanumeric characters. - Content Block names can include any of the following characters: the letters (capitalized or lowercase) A through Z, the numbers 0 through 9, dashes -, and underscores _. It cannot contain non-alphanumeric characters like emojis, !, @, ~, &, and other “special” characters.

• Content Block with this name already exists.

• 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. Please create a new Content Block.

• Tags must be an array.

• All Tags must be Strings.

• Some Tags could not be found.