Skip to main content
POST
/
libraries
/
{libraryId}
/
players
Create Player
curl --request POST \
  --url https://api.tenbyte.io/v1/stream/libraries/{libraryId}/players \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Default Player2"
}
'
{
  "data": {
    "created_at": "2025-10-19T20:00:43.475427+06:00",
    "updated_at": "2025-10-19T20:00:43.475427+06:00",
    "created_by": "ce877d84-c433-46fc-803d-ede73a8375bc",
    "updated_by": "ce877d84-c433-46fc-803d-ede73a8375bc",
    "font_family": "Rubik",
    "custom_html_footer": "<footer>Powered by MyApp</footer>",
    "name": "Default Player",
    "language": "en",
    "custom_html_head": "<!-- Custom analytics script -->",
    "playback_speeds": [
      0.5,
      1,
      1.5,
      2
    ],
    "appearance": {
      "primary_color": "#1D9BF0",
      "caption_font_color": "#FFFFFF",
      "caption_background_color": "#000000",
      "font_size": 16,
      "caption_font_size": 18
    },
    "library_id": "b17ccdc7-eb3d-4d03-b0af-781d3c38c7e9",
    "organization_id": "8babf060-e844-49e5-893c-35d0bf2edfc6",
    "id": "1aaff3a6-5d28-4be5-a503-eff1f33e7010",
    "controls": {
      "backward": true,
      "forward": true,
      "big_play_button": true,
      "captions": true,
      "current_time": true,
      "duration": true,
      "fullscreen": true,
      "mute": true,
      "picture_in_picture": true,
      "play_pause": true,
      "progress": true,
      "settings": true,
      "volume": true
    },
    "is_beta_enabled": true,
    "is_default": false,
    "enable_resumable_position": true
  },
  "message": "Player Created Successfully",
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
libraryId
string
required

Unique identifier of the library.

Body

application/json
​
name
string
required

Name of the player configuration used to identify it within your account.

​
language
string

Default language code for interface text (e.g., en, es).

​
font_family
string

Font family used for player UI text.

​
custom_html
string

Custom HTML or script snippets to embed in the player.

​
playback_speeds
(number | integer)[]

List of playback speed options available to users (e.g., 0.5x, 1x, 1.5x, 2x).

​
is_beta_enabled
boolean

Enables experimental or beta player features for testing.

​
is_default
boolean

Marks this player configuration as the default for all videos.

​
enable_resumable_position
boolean

Allows viewers to resume playback from their last watched position.

​
vast_tag_url
boolean

VAST ad tag URL for video ad integration. Leave empty if ads are not used.

​
dynamic_watermark
object

Defines watermark display settings such as font, color, and movement interval.

​
analytics
object

Contains analytics integration details for tracking player performance and engagement.

​
appearance
object

Controls the visual appearance of the player including colors, fonts, and logo.

​
controls
object

Defines player control visibility and functionality, including playback, captions, and casting options.

Response

​
data
object
required
​
message
string
required
​
success
boolean
required