---
title: "Update funnel (legacy)"
method: PUT
path: "/audiences/{audienceId}/funnels/{funnelId}"
tags: ["Funnels"]
---

# Update funnel (legacy)

`PUT /audiences/{audienceId}/funnels/{funnelId}`

Update a funnel. <br> <br> <br> _This endpoint is for Audience Studio legacy. For the latest Audience Studio, contact your Customer Success Representative._

## Path parameters

- `audienceId` integer, required
- `funnelId` integer, required

## Request body

- FunnelParameters
  - `name` string, required — name
  - `description` string — description
  - `segmentFolderId` integer, required
  - `stages` object[], required — funnel stages
    - `id` integer — null means new stage, non-null means no-op or updating existing stage name or updating stage orders
    - `name` string, required

## Response `200`

Succeeded to update funnel

- Funnel
  - `id` string, integer
  - `audienceId` string, integer
  - `segmentFolderId` string, integer
  - `name` string
  - `population` integer, nullable — The latest population of the funnel
  - `description` string
  - `numSyndications` integer
  - `needToRunWorkflow` boolean — true if need to run workflow to load data
  - `stages` object[] — funnel stages
    - `id` string
    - `name` string
    - `numSyndications` integer
    - `audienceId` string
    - `funnelId` string
    - `segmentFolderId` string
    - `segmentId` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `createdBy` User
    - `id` string
    - `td_user_id` string
    - `name` string
  - `updatedBy` User
    - `id` string
    - `td_user_id` string
    - `name` string

## Other responses

- `400` — Given parameters are not valid
- `401` — Unauthorized; You don't provide valid credentials. Maybe you didn't specify valid TD's Master API Key as 'TD1 {Your TD Master API Key}'.
- `403` — Requested resource or action is not allowed because you don't have sufficient permissions
- `404` — The specified resource was not found
- `4XX` — There is a high possibility of error of the authentication system. Please check the contents and authority of the key. Please contact the TD support team if you do not resolve it.
- `5XX` — System error. Because there is a possibility of a temporary error due to network trouble and so on, we recommend several times retry on request side. Please contact the TD support team if you do not resolve it.

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)