# Update funnel (legacy)

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

Endpoint: PUT /audiences/{audienceId}/funnels/{funnelId}
Version: 1.0.0
Security: TdApikeyAuth

## Path parameters:

  - `audienceId` (integer, required)
    Master Segment ID

  - `funnelId` (integer, required)
    Funnel ID

## Request fields (application/json):

  - `name` (string, required)
    name

  - `description` (string)
    description

  - `segmentFolderId` (integer, required)

  - `stages` (array, required)
    funnel stages
    Example: [{"name":"Awareness"},{"id":1,"name":"Interest"},{"name":"Conversion"}]

  - `stages.id` (integer)
    null means new stage, non-null means no-op or updating existing stage name or updating stage orders

  - `stages.name` (string, required)

## Response 200 fields (application/json):

  - `id` (string)

  - `audienceId` (string)

  - `segmentFolderId` (string)

  - `name` (string)

  - `population` (integer,null)
    The latest population of the funnel

  - `description` (string)

  - `numSyndications` (integer)

  - `needToRunWorkflow` (boolean)
    true if need to run workflow to load data

  - `stages` (array)
    funnel stages
    Example: [{"id":"1","name":"Awareness","numSyndication":2,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":"999"},{"id":"2","name":"Interest","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null},{"id":"3","name":"Conversion","numSyndications":0,"audienceId":"1","funnelId":"10","segmentFolderId":"30","segmentId":null}]

  - `stages.funnelId` (string)

  - `stages.segmentId` (string,null)

  - `createdAt` (string)

  - `updatedAt` (string)

  - `createdBy` (object)

  - `createdBy.td_user_id` (string)

  - `updatedBy` (object)

## Response 400 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 401 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 403 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 404 fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 4XX fields (application/json):

  - `code` (string, required)

  - `message` (string, required)

## Response 5XX fields (application/json):

  - `status` (integer, required)
    Error status

  - `error` (string, required)
    Error message

  - `details` (string)
    Detailed error message