POST /funnels/add_videos

Detailed Description

Adds one or more videos to an existing funnel, including their position coordinates in the funnel layout. Use this when composing or updating the funnel canvas.

⚠️ Important: When calling this endpoint, you must pass all videos currently in the funnel, not only the new ones being added. Otherwise, previously added videos will be overwritten.

HTTP Method & Path

POST /funnels/add_videos

Authentication Requirements

Security Scheme: PandaAuth (apiKey)
Header: Authorization: <your_api_token>

Parameters

Name	Type	Required	Description
Authorization	string (header)	Yes	Panda API token

Request Body

Schema: `AddVideosRequest` (top-level)

Name	Type	Required	Description
id	string (uuid)	Yes	Funnel ID to add videos to.
videos	array of objects	Yes	List of videos to add with their coordinates.

`videos[]` item

Name	Type	Required	Description
id	string (uuid)	Yes	Video ID.
is_first	boolean	Yes	Indicates whether this video is the first video in the funnel.
front_coordinates	object	Yes	Position coordinates for the video in the funnel.

`videos[].front_coordinates`

Name	Type	Required	Description
x	number	Yes	X coordinate position.
y	number	Yes	Y coordinate position.

Example Request Body

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "videos": [
    {
      "id": "456e7890-e89b-12d3-a456-426614174111",
      "is_first": true,
      "front_coordinates": { "x": 100, "y": 200 }
    },
    {
      "id": "789e0123-e89b-12d3-a456-426614174222",
      "is_first": false,
      "front_coordinates": { "x": 320, "y": 160 }
    }
  ]
}

Notes

All videos[] entries require both id and front_coordinates with x and y.