filescom-sync-runs

A SyncRun represents a single execution (run) of a Sync job. It tracks status, statistics, logs, and timing for each sync operation.

All subcommands also accept the flags documented in CONTEXT.md (--api-key, --format, --workspace-id, --debug, and the pagination flags --cursor / --per-page / --max-pages on list). Those are not repeated below.

Commands

files-cli sync-runs list

List Sync Runs.

Flag	Type	Description
--user-id	int64	User ID. Provide a value of 0 to operate the current session's user.
--sort-by	object	If set, sort records by the specified field in either asc or desc direction. Valid fields are site_id, workspace_id, sync_id, created_at or status.
--filter	object	If set, return records where the specified field is equal to the supplied value. Valid fields are created_at, status, dry_run, workspace_id, src_remote_server_type, dest_remote_server_type or sync_id. Valid field combinations are [ status, created_at ], [ workspace_id, created_at ], [ src_remote_server_type, created_at ], [ dest_remote_server_type, created_at ], [ sync_id, created_at ], [ workspace_id, status ], [ src_remote_server_type, status ], [ dest_remote_server_type, status ], [ sync_id, status ], [ workspace_id, src_remote_server_type ], [ workspace_id, dest_remote_server_type ], [ workspace_id, sync_id ], [ workspace_id, status, created_at ], [ src_remote_server_type, status, created_at ], [ dest_remote_server_type, status, created_at ], [ sync_id, status, created_at ], [ workspace_id, src_remote_server_type, created_at ], [ workspace_id, dest_remote_server_type, created_at ], [ workspace_id, sync_id, created_at ], [ workspace_id, src_remote_server_type, status ], [ workspace_id, dest_remote_server_type, status ], [ workspace_id, sync_id, status ], [ workspace_id, src_remote_server_type, status, created_at ], [ workspace_id, dest_remote_server_type, status, created_at ] or [ workspace_id, sync_id, status, created_at ].
--filter-gt	object	If set, return records where the specified field is greater than the supplied value. Valid fields are created_at.
--filter-gteq	object	If set, return records where the specified field is greater than or equal the supplied value. Valid fields are created_at.
--filter-lt	object	If set, return records where the specified field is less than the supplied value. Valid fields are created_at.
--filter-lteq	object	If set, return records where the specified field is less than or equal the supplied value. Valid fields are created_at.

files-cli sync-runs find

Show Sync Run.

Flag	Type	Description
--id	int64	Sync Run ID. Required.