API reference / Analytics
Change a funnel
Renames a funnel or replaces its steps. Results always read the steps as they are now.
/api/v1/analytics/funnels/{id}Other ways to call it
troopy analytics funnels updateIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
id*stringA 24-character id
Body
application/jsonnamestringAt least 1 characters · At most 80 characters
stepsarray<object>At most 8 items
6 properties
kind*enum<string>pagegoal
value*stringA path like /pricing, or a goal's name
At least 1 characters · At most 200 characters
matchenum<string>Pages only: how the path matches
exactstarts_withcontains
Default "exact"
hostnamestring | nullPages only: on this hostname alone
Default null
completedbooleanGoals only: false counts visitors who did not complete it after the step before
Default true
propertyobject | nullGoals only: the goal counts only when it has this property, such as plan pro
Default null
2 properties
name*stringvalue*stringAt least 1 characters · At most 255 characters
hoursinteger | nullThe visitor completes every step within this many hours of the first. Null: any time in the period
strictbooleantrue: no other page between two steps
Response
200 · application/jsondata*object6 properties
id*stringA 24-character id
name*stringsteps*array<object>6 properties
kind*enum<string>pagegoal
value*stringA path like /pricing, or a goal's name
At least 1 characters · At most 200 characters
match*enum<string>Pages only: how the path matches
exactstarts_withcontains
Default "exact"
hostname*string | nullPages only: on this hostname alone
Default null
completed*booleanGoals only: false counts visitors who did not complete it after the step before
Default true
property*object | nullGoals only: the goal counts only when it has this property, such as plan pro
Default null
2 properties
name*stringvalue*stringAt least 1 characters · At most 255 characters
hours*integer | nullThe visitor completes every step within this many hours of the first. Null: any time in the period
strict*booleantrue: no other page between two steps
createdAt*stringISO 8601 date and time