Funnels::ConditionalSplitStep
Update Conditional Split Step
Update the condition and/or attach pages to existing branches. At least one of the two must be provided.
- condition.filter_id is the public id of a RefineFilter in the same workspace.
- Branches array must have 2 entries (matched, unmatched). Each entry may carry a page_id to attach (currently empty branch) or swap (currently populated branch). Any page being attached / swapped-in must be a fresh user_page in the same workspace with no existing ShowPageStep.
patch/funnels/{funnel_id}/conditional_split_steps/{id}
Path parameters
funnel_idinteger required
idinteger required
Request body
Example request
{
"conditional_split_step": {
"condition": {
"filter_id": "AbCdEf"
},
"branches": [
{
"page_ids": [
600,
601,
602
]
},
{
"page_id": 603
}
]
}
}Response
OK
Example response
{
"id": 9876,
"public_id": "CsXyZ1",
"funnel_id": 42,
"funnel_public_id": "xYz123",
"condition": {
"filter_id": "AbCdEf",
"is_setup": true,
"filter": {
"id": 42,
"public_id": "AbCdEf",
"workspace_id": 5,
"name": "VIP newsletter audience",
"filter_class": "ContactsFilter",
"conjunction": "and",
"criteria": [
{
"attribute": "tags.id",
"clause": "in",
"value": [
"tag-pub-id-1"
]
}
],
"created_at": "2026-04-01T12:00:00.000Z",
"updated_at": "2026-04-01T12:00:00.000Z"
}
},
"branches": [
{
"show_page_step": {
"id": 200,
"public_id": "ShPgMa",
"name": "Matched Page step",
"current_path": "/matched"
},
"page": {
"id": 600,
"public_id": "PgMatch",
"name": "Matched Page"
}
},
{
"show_page_step": null,
"page": null
}
],
"created_at": "2026-05-01T00:00:00.000Z",
"updated_at": "2026-05-01T00:00:00.000Z"
}