Printago API
GET /v1/integrations/cloud-storage/{provider}/{integrationId}/sync-records

List all file sync records for a cloud-storage integration

List all file sync records for a cloud-storage integration.

Requires: integration.view

Path Parameters

provider required
string
The cloud storage provider
integrationId required
string
The cloud storage integration ID

Response Schema

CloudStorageSync[]
Array of CloudStorageSync, each with:
createdAtrequired
string
format: date-time
idrequired
string
pattern: ^[a-z0-9]{24}$
integrationIdrequired
string
pattern: ^[a-z0-9]{24}$
lastErrorrequirednullable
string
Error message if status is 'error'.
lastSyncedAtrequirednullable
string
Timestamp of last successful sync.
format: date-time
partIdrequirednullable
string
The Printago part ID this file is synced to.
pattern: ^[a-z0-9]{24}$
providerrequired
"google-drive" | "onedrive"
google-driveonedrive
remoteFileHashrequirednullable
string
Provider-supplied opaque hash of the remote file for change detection.
remoteFileIdrequired
string
The remote file ID from the cloud provider.
remoteFileNamerequired
string
The remote file name.
remoteFileSizerequirednullable
number
Size in bytes of the remote file.
remoteFolderIdrequired
string
The remote folder ID that actually contains the file.
remoteFolderPathrequirednullable
string
Folder names between the watched folder and the file, joined with "/" (e.g. "Prototypes/Brackets"). Null or empty for a file sitting directly in the watched folder. Lets the UI show where a file lives, which the opaque remoteFolderId cannot.
remoteModifiedAtrequirednullable
string
Last modified timestamp from the remote provider.
format: date-time
statusrequired
"synced" | "pending" | "error" | "deleted_remotely" | "removed_locally"
Current sync status.
syncedpendingerrordeleted_remotelyremoved_locally
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
updatedAtrequired
string
format: date-time

Example Response

200 OK — application/json 
[
  {
    "integrationId": "string",
    "provider": "google-drive",
    "remoteFileId": "string",
    "remoteFileName": "string",
    "remoteFolderId": "string",
    "remoteFolderPath": "string",
    "partId": "string",
    "remoteFileHash": "string",
    "remoteFileSize": 1,
    "remoteModifiedAt": "2025-01-15T12:00:00.000Z",
    "status": "synced",
    "lastError": "string",
    "lastSyncedAt": "2025-01-15T12:00:00.000Z",
    "id": "string",
    "storeId": "string",
    "createdAt": "2025-01-15T12:00:00.000Z",
    "updatedAt": "2025-01-15T12:00:00.000Z"
  }
]