Skip to main content
POST
Sync a data connector URI into a file

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

The ID of the data connector

Body

application/json
url
string
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>.

Example:

"grain://recording/abc123"

Response

The synced file

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 in milliseconds when the file was created

filename
string

Original filename

metadata
object | null

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

media_type
enum<string>

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

Available options:
video,
audio,
image
media_info
object

Unified media information for video, audio, and image files

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,
google-drive,
zoom,
gong,
recall,
gcs,
grain,
loom
source_metadata
object

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).