CLcloudglue
Collections

Add a media file to a collection

Changed on

Add a video or audio file to a collection. This is the recommended endpoint for adding media files to collections.

Media Type Handling:

  • Video files: Processed with full visual analysis (scene description, text extraction, etc.)
  • Audio files: Visual features automatically disabled; only speech and audio analysis available

Audio File Restrictions:

  • Audio files cannot be added to face-analysis collections
  • Shot-detector segmentation is not available for audio files
post/collections/{collection_id}/media

Request

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

Path parameters

collection_idstring required

The ID of the collection to add the media file to

Request body

OR

Response

Successful file addition

collection_idstring required

ID of the collection

file_idstring required

ID of the file

object'collection_file' required

Object type, always 'collection_file'

added_atinteger required

Unix timestamp in milliseconds when the file was added to the collection

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

Overall processing status of the file in this collection

searchable_status'pending' | 'processing' | 'completed' | 'failed'

Indexing status of the file's search documents in this collection. Only present for media-descriptions, rich-transcripts, metadata, and entities collections. For entities collections it tracks entity indexing: file-level collections index one document per file, segment-level collections one per segment.

Changes

  • 23d3f240819fRevision changes
    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 725b9736a231Revision changes
    • info

      added the optional property to the response with the status