CLcloudglue
Files

Refresh a file's connector source metadata

Changed on

Re-fetches the file's source_metadata live from its data connector (google-drive, dropbox, zoom, gong, recall, grain, or iconik) and updates the stored value. If the file belongs to any metadata collections, their search documents are re-indexed with the refreshed metadata. For iconik files without a thumbnail, the asset's poster keyframe is also copied and set as the file's thumbnail_url. Works for both metadata-only files and fully ingested connector files. Free — no media is downloaded or processed.

post/files/{file_id}/sync

Request

  • Base URL
    https://api.cloudglue.dev/v1
  • Auth
    HTTP bearer

Path parameters

file_idstring uuid required

The ID of the file to sync

Response

File with refreshed source metadata

idstring required

Unique identifier for the file

status'pending' | 'processing' | 'completed' | 'failed' | 'not_applicable' required

Processing status of the file

bytesinteger nullable

Size of the file in bytes, null if not available

created_atinteger

Unix timestamp in milliseconds when the file was created

filenamestring

Original filename

uristring required

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

metadataobject nullable

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

media_type'video' | 'audio' | 'image'

Type of media file (video, audio, or image). Images are processed at the file level only (no segmentation).

thumbnail_urlstring

URL of the thumbnail for the file

source'video' | 'youtube' | 's3' | 'dropbox' | 'http' | 'upload' | 'google-drive' | 'zoom' | 'gong' | 'recall' | 'gcs' | 'grain' | 'loom' | 'iconik'

Source of the file

Changes