Update the status of a hypothesis

post

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

Changes the status of an existing hypothesis (e.g., from 'draft' to 'completed', 'applied', 'proven', 'disproven', or 'archived'). This helps track the lifecycle of a hypothesis from idea to tested outcome.

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 into which the hypothesis is stored

hypothesis_id

integer

required

ID of the hypothesis to be updated

Query Params

expand

array of objects

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

status

string

enum

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

200Detailed information for a single hypothesis, including its name, objective, prioritization model (PIE/ICE) and scores, status, start/end dates, summary, and links to associated experiences and tags.

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.