Update multiple hypotheses at once

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/hypotheses/bulk-update

Allows for changing the status of multiple hypotheses within a project simultaneously. Requires a list of hypothesis IDs and the target status.

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

Body Params

Contains a list of hypothesis ids and the target status to apply to all of them.

Request body for bulk updating the status of multiple hypotheses.

array of integers

required

length between 1 and 100

A list of hypothesis unique numerical identifiers to be affected by a bulk operation.

id*

status

string

enum

required

The current stage or outcome of a hypothesis in its lifecycle:

draft: The hypothesis is still being formulated or refined; not yet ready for testing.
completed: The hypothesis definition is finalized and it's ready to be linked to an experiment or tested.
applied: The hypothesis is currently being tested in one or more active experiences.
proven: Testing has concluded, and the hypothesis was validated (i.e., the proposed change led to a positive, statistically significant outcome). Can be moved to Knowledge Base.
disproven: Testing has concluded, and the hypothesis was invalidated (i.e., the proposed change did not lead to the expected positive outcome or had a negative impact). Can be moved to Knowledge Base.
archived: The hypothesis is no longer active or relevant for current testing but is kept for historical records. KB: "Hypotheses (Compass)" - "Status of Hypothesis".

Allowed:

Responses

200Indicates the outcome of a bulk operation (e.g., bulk update or delete). Provides a general success message and an errors array listing any entities that could not be processed, along with the reason for failure for each.