Update funnel REST API

PUT

/api/sites/{id}/funnels/{funnelID}

curl --request PUT \
  --url http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/funnels/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --cookie hk_token=<hk_token> \
  --data '{ "created_at": "2026-04-15T12:00:00Z", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "site_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "steps": [ { "type": "event", "value": "example" } ] }'

Updates a site-scoped funnel in place and invalidates its rollups.

Authorizations

• cookieAuth

Parameters

Path Parameters

id

required

string format: uuid

funnelID

required

string format: uuid

Request Body^required

Media typeapplication/json

object

created_at

string format: date-time

id

string format: uuid

name

string

site_id

string format: uuid

steps

Array<object>

object

type

string

Allowed values: event path

value

string

Responses

200

Updated funnel

Media typeapplication/json

object

created_at

string format: date-time

id

string format: uuid

name

string

site_id

string format: uuid

steps

Array<object>

object

type

string

Allowed values: event path

value

string

Example

{
  "steps": [
    {
      "type": "event"
    }
  ]
}

404

Funnel not found

Media typeapplication/json

object

message

string

Example^generated

{
  "message": "example"
}