Update content block

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/i/content/save

Overview

Updates an existing content block when content_id is provided.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• Required permission: Update on the content feature

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or auth_token)	API key for authentication
auth_token	String	Yes (or api_key)	Auth token for authentication
app_id	String	Yes	Application identifier
content_id	String	Yes	Content block ObjectID to update
type	String	Yes	Content block type
blocks	String	Yes	JSON stringified array of block objects
details	String	Yes	JSON stringified object with metadata (created, creatorId, favorite, title)

Examples

Example 1: Update Request

/i/content/save?api_key=YOUR_API_KEY&app_id=5be987d7b93798516eb5289a&content_id=5d4472152de8f07336f3b352&type=modal&blocks=<JSON_STRING>&details=<JSON_STRING>

blocks object before stringifying:

[
  {
    "layout": "modal",
    "elements": {
      "title": {
        "text": "Updated Welcome"
      }
    }
  }
]

details object before stringifying:

{
  "title": "Updated Welcome Modal",
  "creatorId": "5d4472152de8f07336f3b100",
  "favorite": true,
  "created": 1567474533960
}

Response

Success Response

{
  "status": "Success",
  "contentId": "507f1f77bcf86cd799439011"
}

Response Fields

Field	Type	Description
status	String	Operation status
contentId	String	Updated content block ID

Error Responses

HTTP Status	Response
400	JSON parsing error or "Invalid request"
400	Validation/processing error message (e.message)
500	"Error"

Behavior

1. Uses branch when content_id is present.
2. Parses blocks and details from JSON strings.
3. Updates the document by _id + app.
4. Uses upsert: true in update operation.
5. Returns status and contentId.

Limitations

• Entire blocks payload is replaced by provided value.
• Update path is implemented with upsert behavior.

Related Endpoints

• Content Blocks - Read: Retrieve content blocks
• Content Blocks - Create: Create a content block
• Content Blocks - Delete: Delete a content block

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.content_blocks	Endpoint data source	** - Content block definitions