Contents
Create Series - Plugixa Stream
POST /plugixa-stream/v1/admin/series
Create a title. A movie is a title with exactly one video: create it here with kind: movie, then its video with Create Episode.
Needs a user with the plugixa_stream_create capability (signed in with an Application Password or the login cookie). Administrators hold it; other roles only when you grant it.
Request
POST https://your-site.example/wp-json/plugixa-stream/v1/admin/series
Request body
Content type: application/json
| Field | Type | Required | Description |
|---|---|---|---|
title |
string |
Yes on create | Must not be blank. |
synopsis |
string |
No | HTML; tags WordPress does not allow in posts are removed. |
status |
string |
No | draft (the default) or publish. Anything else reads as draft. |
kind |
string |
No | series (the default) or movie. A title with more than one episode cannot become a movie. |
release_year |
integer |
No | 1900 to next year; anything else clears it. |
poster_id |
integer |
No | A Media Library image id, 0 for none. Also set as the featured image. |
banner_id |
integer |
No | A Media Library image id, 0 for none. |
trailer_url |
string |
No | A link to the trailer. |
age_rating |
string |
No | Empty, all, 7+, 13+, 16+ or 18+. Anything else clears it. |
release_status |
string |
No | ongoing (the default) or completed. |
featured |
boolean |
No | Show it in the home hero carousel. |
free_count |
integer|null |
No | Free episodes at the start, 0 to 1000. null or empty follows the site’s Free episodes per series setting. |
original_lang |
string |
No | The spoken language, a tag such as en or pt-BR. |
genres |
integer[] |
No | Term ids. Replaces the title’s genres. Also tags, studios and languages. |
Ids in genres, tags, studios and languages come from List Terms; Create Term adds one.
{
"title": "Sintel",
"kind": "movie",
"status": "draft",
"release_year": 2010,
"age_rating": "13+",
"original_lang": "en",
"genres": [39, 35]
}
Responses
201 Created. data is the new title.
{
"success": true,
"data": {
"id": 2681,
"title": "Sintel",
"slug": "sintel",
"synopsis": "A lonely young woman, Sintel, helps and befriends a dragon, whom she calls Scales.",
"status": "draft",
"url": "https://your-site.example/series/sintel/",
"modified_at": "2026-10-30 14:12:05",
"episode_count": 0,
"kind": "movie",
"release_year": 2010,
"poster_id": 0,
"banner_id": 0,
"trailer_url": "",
"age_rating": "13+",
"release_status": "completed",
"featured": false,
"free_count": null,
"original_lang": "en",
"poster_url": "",
"banner_url": "",
"genres": [39, 35],
"tags": [],
"studios": [],
"languages": []
}
}
| Field | Type | Meaning |
|---|---|---|
data.id |
integer |
The title’s id |
data.title |
string |
Raw title |
data.slug |
string |
URL slug |
data.synopsis |
string |
As stored: HTML without automatic paragraphs |
data.status |
string |
publish or draft |
data.url |
string |
Public page |
data.modified_at |
string |
Last change, site time, Y-m-d H:i:s |
data.episode_count |
integer |
Published, draft and scheduled episodes |
data.kind |
string |
series or movie |
data.release_year |
integer|null |
Release year |
data.poster_id |
integer |
Media Library id, 0 for none |
data.banner_id |
integer |
Media Library id, 0 for none |
data.trailer_url |
string |
Trailer link |
data.age_rating |
string |
Empty, all, 7+, 13+, 16+ or 18+ |
data.release_status |
string |
ongoing or completed |
data.featured |
boolean |
In the home hero carousel |
data.free_count |
integer|null |
Free episodes at the start; null follows the site default |
data.original_lang |
string |
Spoken language tag |
data.poster_url |
string |
Poster, medium size |
data.banner_url |
string |
Banner, large size |
data.genres |
integer[] |
Genre ids. Also tags, studios and languages |
Errors
| Status | Code | When |
|---|---|---|
401 / 403 |
plugixa_stream_forbidden |
The caller lacks the capability. |
422 |
plugixa_stream_invalid |
title is missing or blank. data.field is title. |
Plus the errors every endpoint can return.
Examples
curl -s -X POST "https://your-site.example/wp-json/plugixa-stream/v1/admin/series" \
-u "$WP_USER:$WP_APP_PASSWORD" \
-H "Content-Type: application/json" \
-d '{"title":"Sintel","kind":"movie","status":"draft","release_year":2010,"age_rating":"13+","original_lang":"en","genres":[39,35]}'
<?php
$ch = curl_init('https://your-site.example/wp-json/plugixa-stream/v1/admin/series');
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' => 'Sintel',
'kind' => 'movie',
'status' => 'draft',
'release_year' => 2010,
'age_rating' => '13+',
'original_lang' => 'en',
'genres' => [39, 35],
]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-site.example/wp-json/plugixa-stream/v1/admin/series', {
method: 'POST',
headers: {
'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ title: 'Sintel', kind: 'movie', status: 'draft', release_year: 2010, age_rating: '13+', original_lang: 'en', genres: [39, 35] }),
});
const { data } = await response.json();
Quick Links
Share