Initiates a video upload using the TUS protocol. On success, the server responds with a status code 201 (created) and includes a `location` header to indicate where the content should be uploaded. Refer to https://tus.io for protocol details.
/accounts/{account_identifier}/stream
post
Stream Videos
stream-videos-initiate-video-uploads-using-tus
null null [
{
"in": "header",
"name": "Tus-Resumable",
"required": true,
"schema": {
"description": "Specifies the TUS protocol version. This value must be included in every upload request.\nNotes: The only supported version of TUS protocol is 1.0.0.",
"enum": [
"1.0.0"
],
"example": "1.0.0",
"type": "string"
}
},
{
"in": "header",
"name": "Upload-Creator",
"schema": {
"description": "A user-defined identifier for the media creator.",
"example": "creator-id_abcde12345",
"maxLength": 64,
"type": "string"
}
},
{
"in": "header",
"name": "Upload-Length",
"required": true,
"schema": {
"description": "Indicates the size of the entire upload in bytes. The value must be a non-negative integer.",
"minimum": 0,
"type": "integer"
}
},
{
"in": "header",
"name": "Upload-Metadata",
"schema": {
"description": "Comma-separated key-value pairs following the TUS protocol specification. Values are Base-64 encoded.\nSupported keys: `name`, `requiresignedurls`, `allowedorigins`, `thumbnailtimestamppct`, `watermark`, `scheduleddeletion`.",
"example": "name aGVsbG8gd29ybGQ=, requiresignedurls, allowedorigins ZXhhbXBsZS5jb20sdGVzdC5jb20=",
"type": "string"
}
},
{
"in": "path",
"name": "account_identifier",
"required": true,
"schema": {
"description": "The account identifier tag.",
"example": "023e105f4ecef8ad9ca31a8372d0c353",
"maxLength": 32,
"type": "string"
}
}
] {
"content": {
"application/json": {}
},
"required": true
} {
"200": {
"content": {
"application/json": {}
},
"description": "Initiate video uploads using TUS response"
},
"4XX": {
"content": {
"application/json": {}
},
"description": "Initiate video uploads using TUS response failure"
}
} [
{
"api_email": [],
"api_key": []
}
]