Skip to main content

Series

There are definitely times when stand-alone shows are more suitable, such as time-specific pieces including latest releases or news posts. However, creating a show series provides you with multiple opportunities to engage your target audience. You can really get to grips with complex topics and impart far more valuable information than with a stand-alone show.

Get Get User Series

gethttps://cache.showwcase.com/user/:username/series
gethttps://cache.showwcase.com/series/featured

Get Get Series

gethttps://cache.showwcase.com/projects/series/:seriesId

Post Create Series

Each new series is created in draft state by default, such series will not be visible in public feeds until you publish them.

posthttps://cache.showwcase.com/projects/series
Headers
FieldDescription
X-API-KEYAn API key that represents the user who wants to take an action. Read more about API keys here.

Get Get Series Drafts

gethttps://cache.showwcase.com/profile/series/drafts
Headers
FieldDescription
X-API-KEYAn API key that represents the user who wants to take an action. Read more about API keys here.
Query
FieldTypeDescription
skip

Default value: 0

numberPagination offset.
limit

Default value: 15

numberPagination limit. (Max value 100)

Put Update Series

puthttps://cache.showwcase.com/projects/series/:seriesId
Headers
FieldDescription
AuthorizationAn access token that represents the user who wants to take an action. Read more about access tokens here.
Body
FieldTypeDescription
titlestringSeries title.
descriptionstringSeries title.
categoryIdnumber|number[]Unique category Id(s).
difficulty

Default value: beginner

stringSeries difficulty level.

Allowed values: beginner, intermediate, expert

seoobjectSEO properties.
settingsobjectCustom settings.

Delete Delete Series

deletehttps://cache.showwcase.com/projects/series/:seriesId
Headers
FieldDescription
AuthorizationAn access token that represents the user who wants to take an action. Read more about access tokens here.

Post Publish Series

posthttps://cache.showwcase.com/projects/series/:seriesId/publish
Headers
FieldDescription
X-API-KEYAn API key that represents the user who wants to take an action. Read more about API keys here.

Bulk update list of shows in Series

To update list of shows all at once.

posthttps://cache.showwcase.com/projects/series/:seriesId
Headers
FieldDescription
X-API-KEYAn API key that represents the user who wants to take an action. Read more about API keys here.
Parameters
FieldTypeDescription
seriesIdstringUnique series id.
Body
FieldTypeDescription
projectsarrayArray of objects that contains unique shows.
projects.projectIdnumberUnique project id.
levelnumber
depthnumber

Post Add Show to Series

posthttps://cache.showwcase.com/projects/:projectId/series/:seriesId
Headers
FieldDescription
X-API-KEYAn API key that represents the user who wants to take an action. Read more about API keys here.
Body
FieldTypeDescription
levelnumberShow order level.
depthnumberShow order depth.
Parameters
FieldTypeDescription
projectIdnumberUnique project's id.
seriesIdnumberUnique series' id.

Delete Remove Show from Series

deletehttps://cache.showwcase.com/projects/:projectId/series/:seriesId
Headers
FieldDescription
AuthorizationAn access token that represents the user who wants to take an action. Read more about access tokens here.
Parameters
FieldTypeDescription
projectIdnumberUnique project's id.
seriesIdnumberUnique series' id.

Series Categories

gethttps://cache.showwcase.com/projects/series/categories
Query
FieldTypeDescription
searchstringSearch by categories title.