Update all sections for an MVT experience

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/experiences/{experience_id}/sections/update

Replaces all existing sections and their versions for a multivariate (MVT) experience with the provided list. If a section or version from the existing configuration is not included in the request, it will be removed. The order of sections, versions, and changes is important and will be preserved. This is a comprehensive update for the entire MVT structure.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project to which save/retrieved data is connected

experience_id

integer

required

The ID of the exeprience for which to update sections

Query Params

include

array of objects

Array parameter that would mention extra fields to be included into the response; otherwise those fields would be excluded by default

Read more in the section related to Optional Fields

include

expand

array of strings

Specifies the list of objects which would be expanded in the response. Otherwise, only their id would be returned.

Read more in the section related to Expanding Fields

expand

Body Params

Request body for updating all sections (and their versions/changes) for a Multivariate (MVT) experience. The provided list of sections will completely replace the existing MVT structure. Any existing sections not included in the request will be removed. The order of sections, versions, and changes is significant and will be preserved. Caution: Major structural changes to an active MVT can invalidate test results.

sections

array of objects

An array of UpdateSectionRequestData objects. Each object defines a section and its complete set of versions and changes.

To update an existing section, provide its id and modified name or versions.
To add a new section, provide a new unique id (1-2 chars), name, and its versions.
Sections from the current MVT configuration not present in this array will be deleted.

sections

concurrency_key

string | null

A server-generated hash that represents the object's state at the time of retrieval. When included in an update request, the operation will only succeed if the object hasn't been modified since this key was obtained. If another update has occurred in the meantime, the request will fail with a conflict error, requiring you to fetch the latest version and retry your update with the new concurrency_key. This implements optimistic concurrency control to prevent lost updates in concurrent scenarios.

Responses

200A list of sections defined for a multivariate (MVT) experience. Each section includes its id, name, and an array of its versions (alternatives).

defaultIndicates an error occurred while processing the request. The code provides an HTTP status code, message offers a human-readable explanation or an array of validation errors, and fields (if present) specifies which input fields were problematic.