PUT /aiworkflow/aipackage

Saves the edited content of an AI resource — eBook (abstract), Mind Map (mindmap) or Quiz (questions) — in one language. This is the endpoint that persists what the user changed in the editor.

📘

Authorization

Requires the account API key in the Authorization header, without the Bearer prefix.

⚠️

The PUT replaces the content sent. Any question, alternative or block not present in the payload is removed. Send the complete structure, not a delta.

HTTP Method & Path

PUT /aiworkflow/aipackage

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

Authentication Requirements

Parameters

Request Body

Content-Type: application/json

⚠️

lang is what separates v2 from legacy. With lang, the edit is written to that language's file ({video_external_id}-ai.{lang}.json). Without lang, it is written to the old file ({video_external_id}-ai.json), which is unique per video.

⚠️

When editing an eBook, abstract_html is the canonical source of the PDF. Changing only the abstract markdown may leave the PDF out of sync with the text.

Editing flow

1. Call GET /videos/{video_id} and read config.ai.resources[] to know which resources exist and in which languages. (In the old model the pointer was the ai_url field of the same response.)
2. Fetch the current structure at https://config.tv.pandavideo.com.br/{pullzone_name}/{video_external_id}-ai.{lang}.json — see Get Mind Map, eBook or Quiz.
3. Change what you need, keeping everything that should continue to exist.
4. Send the complete structure in this PUT, with the resource lang.

Example — save an edited Quiz in Portuguese

{
  "video_id": "{video_id}",
  "lang": "pt-BR",
  "questions": [
    {
      "id": "{question_id}",
      "enunciate": "Which vitamin is synthesised through sun exposure?",
      "options": [
        { "text": "Vitamin A", "correct": false },
        { "text": "Vitamin D", "correct": true },
        { "text": "Vitamin K", "correct": false }
      ]
    },
    {
      "enunciate": "A new question, with no id — it will be created",
      "options": [
        { "text": "Right", "correct": true },
        { "text": "Wrong", "correct": false }
      ]
    }
  ],
  "questions_config": { "num_answers": 3, "show_results": true }
}

Example — save an edited eBook in English

{
  "video_id": "{video_id}",
  "lang": "en",
  "abstract": "# Chapter 1\n\nEdited text in markdown...",
  "abstract_html": "<section class=\"panda-ebook\">...</section>",
  "abstract_summary": "Updated summary.",
  "abstract_cover": {
    "kicker": "Biochemistry",
    "title": "Vitamins",
    "subtitle": "Functions, sources and deficiencies",
    "edition_label": "Edition 1"
  }
}

Response

Success Response (200)

Confirms the write. The public file of that language is rewritten right after — CDN propagation is not instantaneous.

Error Responses

• 400: invalid payload (e.g. a question without enunciate, malformed options).
• 401: missing or invalid API key.
• 404: video or resource not found in the given language.
• 500: internal error.

Related operations

Example Usage

cURL

curl -X PUT "https://api-v2.pandavideo.com.br/aiworkflow/aipackage" \
  -H "Authorization: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "{video_id}",
    "lang": "pt-BR",
    "questions": [
      {
        "id": "{question_id}",
        "enunciate": "Which vitamin is synthesised through sun exposure?",
        "options": [
          { "text": "Vitamin A", "correct": false },
          { "text": "Vitamin D", "correct": true }
        ]
      }
    ]
  }'