PUT /funnels/update/{funnel_id}

Updates a funnel's properties. In practice this renames a funnel — name is the only mutable field today.

📘

Authorization

Requires a valid API Key in the Authorization header. Send the key directly — no Bearer prefix.

⚠️

Where is the target funnel identified?

The Panda gateway accepts the funnel id in the body (id). The path segment after /update/ is ignored by the handler — both PUT /funnels/update/{funnel_id} and PUT /funnels/update work, as long as id is in the body. The canonical form used by the dashboard is the one with {funnel_id} in the path (more readable).

HTTP Method & Path

PUT /funnels/update/{funnel_id}

Base URL: https://api-v2.pandavideo.com.br

Path Parameters

Request Body

Content-Type: application/json

Body Parameters

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Sales Funnel Q1 — Reviewed"
}

Response

Success Response (200)

{
  "message": "Funnel updated successfully",
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "organization_id": "11111111-2222-3333-4444-555555555555",
    "name": "Sales Funnel Q1 — Reviewed"
  }
}

Error Responses

• 400 — name shorter than 3 / longer than 50, or body.id missing.
• 403 — user does not belong to the funnel's organization ("User does not have permission to update this funnel.").
• 404 — funnel does not exist.
• 401 — missing/invalid API Key.
• 500 — internal error.

Example Usage

cURL

curl --request PUT \
  --url 'https://api-v2.pandavideo.com.br/funnels/update/a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Authorization: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Sales Funnel Q1 — Reviewed"
  }'

Recipes