PUT
/
files
/
{file_id}
Update a file
curl --request PUT \
  --url https://api.cloudglue.dev/v1/files/{file_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "metadata": {},
  "filename": "<string>"
}'
{
  "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
  },
  "thumbnail_url": "<string>",
  "source": "video"
}

Authorizations

Authorization
string
header
required

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

Path Parameters

file_id
string
required

The ID of the file to update

Body

application/json

File update parameters

metadata
object

Optional user-provided metadata about the file

filename
string

New filename for the file

Response

Successful file update

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

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