---
title: "Update funnel REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Update funnel, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apisitesidfunnelsfunnelid/put/"
---

# Update funnel REST API

PUT

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

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/funnels/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PUT',
  headers: {cookie: 'hk_token=<hk_token>', 'Content-Type': 'application/json'},
  body: '{"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"}]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
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](https://hitkeep.com/api/#cookieauth)**

## Parameters

### Path Parameters

**id**

required

string format: uuid

**funnelID**

required

string format: uuid

## Request Bodyrequired

application/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

application/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

application/json

object

**message**

string

##### Examplegenerated

```
{
  "message": "example"
}
```

[Previous Funnel timeseries](https://hitkeep.com/api/operations/apisitesidfunnelstimeseries/)[Next Delete funnel](https://hitkeep.com/api/operations/apisitesidfunnelsfunnelid/delete/)