Create Video - Plugixa Video

POST /pvx/v1/videos

Add a video, linked to a file, a stream, YouTube or Vimeo, as a draft or published straight away.

Needs a user (signed in with an Application Password or the login cookie) who has the plugixa_video_create capability and the right to edit videos. In the free plugin only administrators hold it; with Pro, editors and the Video Creator role hold it too.

Note. With Pro’s Creators app and review switched on, a Video Creator who asks for publish or pvx_unlisted gets pending instead, and the site administrator is emailed. Uploading a file is not part of this endpoint: point url at a file that is already online.

Request

POST https://your-site.example/wp-json/pvx/v1/videos

Request body

Content type: application/json

The owner is the caller. Fields you do not send take their defaults; fields the plugin does not know are ignored. views and likes cannot be written.

{
  "title": "Iceland: The Ring Road",
  "status": "publish",
  "source": "mp4",
  "url": "https://cdn.your-site.example/videos/ring-road.mp4",
  "duration": 1460,
  "access": "free",
  "channel_id": 692,
  "categories": [14],
  "tags": [31, 32]
}

Responses

201 Created. data is the new video in the back-office shape.

{
  "success": true,
  "data": {
    "id": 838,
    "title": "Iceland: The Ring Road",
    "excerpt": "A week around Iceland on Route 1, from Reykjavik to the glacier lagoons of the south coast.",
    "source": "mp4",
    "type": "video",
    "poster": "https://your-site.example/wp-content/uploads/2026/11/ring-road-1024x576.jpg",
    "poster_srcset": "https://your-site.example/wp-content/uploads/2026/11/ring-road-1024x576.jpg 1024w, https://your-site.example/wp-content/uploads/2026/11/ring-road-300x169.jpg 300w",
    "poster_width": 1024,
    "poster_height": 576,
    "duration": 1460,
    "access": "free",
    "price": 0.0,
    "channel_id": 692,
    "channel": "Far Places",
    "views": 0,
    "likes": 0,
    "categories": [14],
    "permalink": "https://your-site.example/video/iceland-the-ring-road/",
    "date": "2026-11-12T09:30:00+00:00",
    "status": "publish",
    "coming_soon": false,
    "description": "<p>A week around Iceland on Route 1.</p>\n<p>00:00 Reykjavik<br>04:10 The Golden Circle<br>12:30 Jokulsarlon</p>",
    "url": "https://cdn.your-site.example/videos/ring-road.mp4",
    "poster_id": 1201,
    "tags": [31, 32],
    "comments": true,
    "release_date": "2026-11-12T10:30",
    "author": 1,
    "modified": "2026-11-12T09:30:00+00:00"
  }
}

The full shape is described in Get Video.

Errors

Plus the errors every endpoint can return.

Examples

curl -s -X POST "https://your-site.example/wp-json/pvx/v1/videos" \
  -u "$WP_USER:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"title":"Iceland: The Ring Road","status":"publish","source":"mp4","url":"https://cdn.your-site.example/videos/ring-road.mp4","duration":1460,"access":"free","channel_id":692,"categories":[14],"tags":[31,32]}'

<?php
$ch = curl_init('https://your-site.example/wp-json/pvx/v1/videos');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'title'      => 'Iceland: The Ring Road',
        'status'     => 'publish',
        'source'     => 'mp4',
        'url'        => 'https://cdn.your-site.example/videos/ring-road.mp4',
        'duration'   => 1460,
        'access'     => 'free',
        'channel_id' => 692,
        'categories' => [14],
        'tags'       => [31, 32],
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

const response = await fetch('https://your-site.example/wp-json/pvx/v1/videos', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ title: "Iceland: The Ring Road", status: "publish", source: "mp4", url: "https://cdn.your-site.example/videos/ring-road.mp4", duration: 1460, access: "free", channel_id: 692, categories: [14], tags: [31, 32] }),
});
const { data } = await response.json();