Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Castr Video Hosting API

Video hosting folders, uploads, and live-to-VOD recordings.

Castr Video Hosting API is one of 5 APIs that Castr publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Video Hosting. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 10 operations across 8 paths, and defines 7 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.castr.com/v2.

10 operations 8 paths 7 schemas 2 DELETE4 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.castr.com/v2
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Castr Video Hosting API declares 1 security scheme for authenticating requests. An API key is passed in the header as authorization (apiToken). By default, every request must be authenticated.

  • apiToken — API token issued from the Castr account settings API section (https://castr.com/app/manage/api), sent in the authorization header.

Paths & Operations 10

Across 8 paths, the API surfaces 10 operations — 2 DELETE, 4 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Video Hosting 10

Video hosting folders, uploads, and live-to-VOD recordings.

GET
/live_streams/{stream_id}/temporary_recordings
Get temporary recordings
getTemporaryRecordings 1 param → 200404
POST
/live_streams/{stream_id}/temporary_recordings/{recording_id}
Convert live recording to VOD
convertLiveToVod 2 params → 201404
GET
/live_streams/{stream_id}/recordings
Get live-to-VOD recordings
getLiveToVodRecordings 1 param → 200404
GET
/videos
List folders
listFolders → 200401
POST
/videos
Create a folder
createFolder body → 201401
PATCH
/videos/{folder_id}
Update a folder
updateFolder 1 param body → 200404
DELETE
/videos/{folder_id}
Delete a folder
deleteFolder 1 param → 204404
GET
/videos/{folder_id}/contents
List contents in a folder
listFolderContents 1 param → 200404
DELETE
/videos/{folder_id}/contents/{content_id}
Delete content in a folder
deleteFolderContent 2 params → 204404
POST
/videos/{folder_id}/uploads
Create a direct upload URL
createDirectUpload 1 param body → 201404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Video (8 properties), Recording (5 properties), Folder (4 properties), Upload (3 properties). Each schema is shown below with its type and property counts.

FolderCreate
object
1 property 1 required
Folder
object
4 properties
Upload
object
3 properties
Video
object
8 properties
UploadCreate
object
2 properties
Error
object
2 properties
Recording
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

castr-live-video-hosting-api-openapi.yml Raw ↑

Other APIs Castr publishes across the network.

Castr Analytics API
Castr Live Streams API
Castr Sub-Second Streams API
Castr Webhooks API