CLcloudglue
Data Connectors

Sync a data connector URI into a file

Changed on

Materialize a connector URI (e.g. grain://recording/<id>) into a Cloudglue file without starting a downstream job. Idempotent: syncing the same URI returns the existing file. For Grain, Zoom, Recall, Google Drive, Dropbox, and Gong the file's source_metadata is populated from the provider (see the SourceMetadata schema). Plain http(s), TikTok, and Loom URLs are not connector-syncable; ingest those via POST /files/sync instead. YouTube URLs can only be added to a collection via the add-media endpoint.

post/data-connectors/{id}/sync

Request

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

Path parameters

idstring uuid required

The ID of the data connector

Request body

urlstring required

Connector URI to sync. Must match the connector's type. Accepted forms per connector — s3: s3://<bucket>/<key> · gcs: gs://<bucket>/<key> · google-drive: gdrive://file/<fileId> or a https://drive.google.com/file/d/<fileId>/... link · dropbox: dropbox://<path> (as returned by GET /data-connectors/{id}/files) or a https://www.dropbox.com/scl/fi/... share link · zoom: zoom://uuid/<meetingUuid>, zoom://id/<meetingId>, or a https://*.zoom.us join, recording-detail, or rec/share link · grain: grain://recording/<id> · gong: gong://call/<id> · recall: recall://recording/<id> · iconik: iconik://asset/<id>.

Example request

{
  "url": "grain://recording/abc123"
}

Response

The synced file

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

  • 23d3f240819fRevision changes
    • 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

    • 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

  • c02e52ec2e28Revision changes
    • breaking

      added to the //// response property oneOf list for the response status

    • warning

      added the new iconik enum value to the response property for the response status

    • info

      added iconik discriminator mapping keys to the //// response property for the response status