Contents
On this page

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