Create a video entity

To create your video streaming, you need to create an Entity object.

/v1/video-entities

POST https://api.uiza.io/api-vod/owner/v1/video-entities

Request Body

Name	Type	Description
name*	string	The entity's name.
description	string	An arbitrary string attached to the object. Often useful for displaying to users.
encoding_template	string	Indicates whether encoding mode is enabled for the live_entity. Set as sd, hd or fhd to enable and as none to disable.

200

{
  "data": {
    "id": "2b970a39-874a-4d2a-be8a-fd445646d74c",
    "name": "My video 1",
    "description": "Oops",
    "input_url": "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
    "encoding_template": "hd",
    "content_policy": "public",
    "status": "processing",
    "playback": null,
    "created_at": "2020-03-23T07:22:34Z",
    "updated_at": "2020-03-23T07:22:34Z"
  }
}

400

Missing name

{
  "message": "Your request is missing name parameter. Please, verify and resubmit.",
  "error_type": "invalid_request_error"
}

401

{
  "message": "You are unauthorized to access the requested resource. Please verify and resubmit.",
  "error_type": "invalid_request_error"
}5

500

{
  "message": "An unexpected error occurred on Uiza's end.",
  "error_type": "api_error"
}

Sample Request

curl --location --request POST 'https://api.uiza.io/api-vod/owner/v1/video-entities' \
--header 'Authorization: <token>' \
--header 'uiza-app-id: <your_app_id>' \
--data-raw '{
    "name": "My video 1",
    "input_url": "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4",
    "encoding_template": "hd"
}'