Strapi v5 – api.video plugin

A powerful Strapi plugin to easily manage your videos and integrate them in your project.

Core Contributor: Strawbinary
Follow @strawbinary

About this Plugin:
This plugin is a fork of Strapi v4 - api.video uploader,
originally developed by the api.video team under the MIT license.

This version updates the plugin for Strapi 5 and introduces several improvements.

---

!Plugin UI Preview

✨ Features

- Upload videos directly from your Strapi admin via file picker to api.video
- Manage assets with a responsive grid and built-in pagination
- Search your library by title or tags
- Preview with the embedded api.video player (api.video-player-react)
- Delete assets (removes on both Strapi and api.video sides)

⏳ Installation

This plugin is published on npm. You can install it with your preferred package manager—npm, yarn, or pnpm.

``bash


Using npm (recommended)

npm install @strawbinary-io/api-video-strapi-5-plugin@latest

Or with yarn

yarn add @strawbinary-io/api-video-strapi-5-plugin@latest

Or with pnpm

pnpm add @strawbinary-io/api-video-strapi-5-plugin@latest
`

After installation, rebuild your Strapi admin:

`bash
npm run build
npm run develop
`

Once Strapi is up, the API.VIDEO plugin will in the sidebar.

🖐 Requirements

- api.video
- An api.video account
- An API key from the api.video Dashboard
- Node.js
- Version: 20.x – 24.x
- Strapi
- Strapi v5 only (not compatible with v4 or earlier)

🔧 Configuration

Before using the plugin, you must supply your api.video API key in Strapi’s settings panel.

1. In Strapi Admin, go to Settings → API.VIDEO Plugin.
2. Enter your API key and click Save.

$3

To allow thumbnails, embeds and the player to load correctly, update your config/middlewares.ts file with the following security entry:

`ts
export default [
'strapi::logger',
'strapi::errors',
{
name: 'strapi::security',
config: {
contentSecurityPolicy: {
useDefaults: true,
directives: {
'connect-src': ["'self'", 'https:'],
'img-src': ["'self'", 'data:', 'blob:', 'embed.api.video', 'cdn.api.video/vod/'],
'script-src': ["'self'", "'unsafe-inline'", "'unsafe-eval'"],
'frame-src': ["'self'", 'data:', 'blob:', 'embed.api.video'],
upgradeInsecureRequests: null,
},
},
},
},
'strapi::cors',
'strapi::poweredBy',
'strapi::query',
'strapi::body',
'strapi::session',
'strapi::favicon',
'strapi::public',
];
`

👤 Permissions

Configure fine-grained permissions under Roles & Permissions → Plugins.

💾 Metadata

By default, uploads carry an uploadSource metadata field set to "Strapi". This cannot be changed.

🔔 Webhook

The plugin exposes a webhook endpoint to update the video duration once encoding finishes.

1. In the api.video Dashboard, create a webhook for the event video.encoding.quality.completed.
2. Set the webhook URL to your Strapi instance (default Content API prefix):
POST https:///api/api-video-asset/webhook

When the webhook is received and verified, the plugin fetches the video status from api.video and updates the
duration field for the matching asset in Strapi.

🧭 Migrations

This plugin runs one-time migrations during Strapi bootstrap. The migration state is stored
in the Strapi plugin store so each migration runs only once per environment.

- Storage key: migrations (plugin store for api-video-strapi-5-plugin)
- State format: A map of migration IDs with timestamps and result metadata
- Re-run a migration: Delete the entry from the plugin store (or remove the whole migrations key)

$3

- 2026-01-29-backfill-duration-from-status
Backfills the duration field for existing videos by calling client.videos.getStatus(videoId) and
reading metadata.duration` from the status response.

🤝 Contributing

We welcome contributions, issues and feature requests!

- Report bugs or request features in the issue tracker

📚 References

- api.video Documentation
- Strapi Documentation