Delete an AI Resource

Removes an AI resource from one language. The other languages of the same resource keep existing.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

DELETE /aiworkflow/aipackage

Removes one resource from one language: eBook (abstract), Mind Map (mindmap) or Quiz (questions). The other languages of the same resource keep existing.

📘

Authorization

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

🚧

The body goes in the DELETE. This endpoint takes a JSON body — these are not query params. HTTP clients that drop the body on DELETE (some wrappers and proxies do) need to be configured to send it.

HTTP Method & Path

DELETE /aiworkflow/aipackage

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

Authentication Requirements

ItemValue
Security SchemeAPI Key
HeaderAuthorization
FormatThe raw key, without Bearer

Parameters

NameInTypeRequiredDescription
AuthorizationheaderstringYesAccount API key

Request Body

Content-Type: application/json

FieldTypeRequiredDescription
video_idstring (uuid)YesVideo the resource belongs to
resourcestringYesabstract, mindmap or questions
langstringYesLanguage to remove. Required in every call — omitting it returns 400 should have required property 'lang'
{
  "video_id": "{video_id}",
  "resource": "questions",
  "lang": "pt-BR"
}
⚠️

Removal is per language, not per resource. Deleting the pt-BR Quiz does not delete the en Quiz. To remove the whole resource, call once per language — the existing languages are listed in config.ai.resources[].

⚠️

Different from the download permission, which is per resource and applies to every language (see AI Package Actions). Removal is per language; permission is per resource.

Response

Success Response (200)

Confirms the removal. After it:

  • the matching entry disappears from config.ai.resources[] in GET /videos/{video_id};
  • the {video_external_id}-ai.{lang}.json file no longer carries that resource key — and, if it was the last resource of that language, the file stops existing (404);
  • the legacy {video_external_id}-ai.json file, when the video had one, is removed as well.
⚠️

The public files are served through a CDN. Right after the delete you may still read the previous version from cache — the 404 shows up once the cache expires. Add a cache-busting query string when you need to confirm the state immediately.

Error Responses

  • 400: invalid payload — resource outside the enum, or lang missing (should have required property 'lang').
  • 401: missing or invalid API key.
  • 404: video or resource not found in the given language.
  • 500: internal error.

Regenerate instead of deleting

If the goal is to redo the content, do not delete it first: the regenerate action on AI Package Actions deletes and generates again in the same language in a single call — and reuses the configuration of the previous generation.

Example Usage

cURL

curl -X DELETE "https://api-v2.pandavideo.com.br/aiworkflow/aipackage" \
  -H "Authorization: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "video_id": "{video_id}",
    "resource": "questions",
    "lang": "pt-BR"
  }'
Body Params
uuid
required
string
enum
required
Allowed:
string

Language to remove. Without it the legacy resource is removed.

Responses

401

Missing or invalid API key.

404

Video or resource not found.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json