Skip to main content
POST
/
files
Upload a video file that can be used with Cloudglue services
curl --request POST \
  --url https://api.cloudglue.dev/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'metadata={}' \
  --form enable_segment_thumbnails=false
{
  "id": "<string>",
  "status": "pending",
  "uri": "<string>",
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "metadata": {},
  "video_info": {
    "duration_seconds": 123,
    "height": 123,
    "width": 123,
    "format": "<string>",
    "has_audio": true
  },
  "thumbnail_url": "<string>",
  "source": "video"
}

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

​
enable_segment_thumbnails
boolean
default:false

Whether to generate thumbnails for each segment

Response

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

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

​
video_info
object

Information about the video content

​
thumbnail_url
string

URL of the thumbnail for the file

​
source
enum<string>

Source of the file

Available options:
video,
youtube,
s3,
dropbox,
http,
upload,
google-drive,
zoom,
gong,
recall