POST
/
files
curl --request POST \
  --url https://api.cloudglue.dev/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'metadata={}'
{
  "id": "<string>",
  "status": "pending",
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "uri": "<string>",
  "metadata": {},
  "video_info": {
    "duration_seconds": 123,
    "height": 123,
    "width": 123,
    "format": "<string>",
    "has_audio": true
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

multipart/form-data

Upload a video file

​
file
file
required

The video file to be uploaded

​
metadata
object

User-provided metadata about the file

Response

200
application/json

Successful file upload

​
id
string
required

Unique identifier for the file

​
status
enum<string>
required

Processing status of the file

Available options:
pending,
processing,
completed,
failed,
not_applicable
​
uri
string
required

Cloudglue URI for the file, to be used in other API calls

​
bytes
integer | null

Size of the file in bytes, null if not available

​
created_at
integer

Unix timestamp of when the file was created

​
filename
string

Original filename

​
metadata
object | null

User-provided metadata about the file, null if none provided

​
video_info
object

Information about the video content