Sync Data Connector File
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, the file’s source_metadata is populated from the recording. 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.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the data connector
Body
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>.
"grain://recording/abc123"
Response
The synced file
Unique identifier for the file
Processing status of the file
pending, processing, completed, failed, not_applicable Cloudglue URI for the file, to be used in other API calls
Size of the file in bytes, null if not available
Unix timestamp in milliseconds when the file was created
Original filename
User-provided metadata about the file, null if none provided
Type of media file (video or audio)
video, audio Unified media information for both video and audio files
Information about the video content
URL of the thumbnail for the file
Source of the file
video, youtube, s3, dropbox, http, upload, google-drive, zoom, gong, recall, gcs, grain, loom Source provenance captured from the upstream connector at ingest time. Null when nothing was captured (older files, or a connector that does not yet populate it).