# Syncthing

> Watch and steer Syncthing, the open-source file sync between your own devices: get a folder's or device's sync status, rescan a folder after saving files to it, pause and resume folders and devices, list files that won't sync and recent changes, and accept new devices and folders. Start a workflow when a device goes offline or comes back, a folder has errors, or a file changes.

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/syncthing

## Actions

### Accept device

Add a device that is asking to connect to this Syncthing. Only a device waiting to connect can be accepted, and no folder is shared with it.

**Inputs**

- Device (`device`, text, required): The device asking to connect: its full device ID.
- Name (`name`, text): The name to give it. Leave blank for the name it gives itself.

**Outputs**

- `accepted` (true/false): True when this step added it
- `already_added` (true/false): True when it had been added before, so nothing changed
- `device_id` (text): The device's ID
- `name` (text): The name it was added with

**Example output**

```json
{
  "accepted": true,
  "already_added": false,
  "device_id": "P56IOI7-MZJNU2Y-IQGDREY-DM2MGTI-MGL3BXN-PQ6W5BM-TBBZ4TJ-XZWICQ2",
  "name": "Phone"
}
```

### Accept folder

Accept a folder another device offers to share, as Syncthing's Add button does: it's made in Syncthing's default folder location and shared only with the devices offering it.

**Inputs**

- Folder (`folder`, text, required): The folder ID offered, as Syncthing shows it under New Folder.
- Offered by (`device`, text): Only accept it from this device. Leave blank for every device offering it.

**Outputs**

- `accepted` (true/false): True when this step accepted it
- `already_accepted` (true/false): True when it was already shared with the device(s), so nothing changed
- `created` (true/false): True when a new folder was made; false when an existing one was shared
- `folder_id` (text): The folder's ID
- `label` (text): The folder's label
- `path` (text): Where the folder is on this device
- `shared_with` (list): The devices it's shared with, by name

**Example output**

```json
{
  "accepted": true,
  "already_accepted": false,
  "created": true,
  "folder_id": "music-lodol",
  "label": "Music",
  "path": "/config/Music",
  "shared_with": [
    "Laptop"
  ]
}
```

### Get device status

Get a remote device's status: connected or not, its address, when it was last seen, and how much of each folder shared with it it has.

**Inputs**

- Device (`device`, text, required): The remote device: its name or device ID.

**Outputs**

- `address` (text): The address it's connected from; empty when it isn't
- `client_version` (text): Its Syncthing version, while connected
- `completion` (number): How much of the folders shared with it it has, in percent
- `connected` (true/false): True while it's connected
- `device_id` (text): The device's ID
- `folder_progress` (list): Each folder shared with it, and how far it has got
- `folders` (list): The folders shared with it, by label
- `last_seen` (text): When it was last connected (ISO 8601, UTC); empty for never
- `name` (text): The device's name
- `need_bytes` (number): Bytes it still needs
- `need_size` (text): The same, in words, such as 1.2 MiB
- `paused` (true/false): True while it's paused

**Example output**

```json
{
  "address": "192.168.1.40:22000",
  "client_version": "v2.1.7",
  "completion": 100.0,
  "connected": true,
  "device_id": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
  "folder_progress": [
    {
      "completion": 100.0,
      "folder_id": "docs-lodol",
      "label": "Documents",
      "need_bytes": 0,
      "need_items": 0
    }
  ],
  "folders": [
    "Documents",
    "Photos"
  ],
  "last_seen": "2026-11-09T19:46:55Z",
  "name": "Laptop",
  "need_bytes": 0,
  "need_size": "0 B",
  "paused": false
}
```

### Get folder status

Get a folder's sync status: up to date or syncing, the share done and what's left to sync, files that failed, the last file synced, and how far each device it's shared with has got.

**Inputs**

- Folder (`folder`, text, required): The folder: its label or folder ID.

**Outputs**

- `completion` (number): How much of the folder this device has, in percent
- `devices` (list): Each device it's shared with, and how far it has got
- `error` (text): Why the folder stopped, when it did; empty otherwise
- `errors` (number): Files that failed to sync
- `folder_id` (text): The folder's ID, the same on every device
- `global_bytes` (number): The folder's size in bytes
- `global_files` (number): Files in the folder, across all devices
- `label` (text): The folder's label, as Syncthing shows it
- `last_file` (text): The last file synced, as a path in the folder
- `last_file_at` (text): When that file was synced (ISO 8601, UTC)
- `last_file_deleted` (true/false): True when that last change was a deletion
- `last_scan` (text): When this device last scanned it (ISO 8601, UTC)
- `local_files` (number): Files this device has
- `need_bytes` (number): Bytes this device still needs
- `need_items` (number): Files and folders this device still needs
- `need_size` (text): The same, in words, such as 1.2 MiB
- `path` (text): Where the folder is on this device
- `paused` (true/false): True while the folder is paused
- `shared_with` (list): The other devices it's shared with, by name
- `size` (text): The folder's size in words, such as 4.5 GiB
- `state` (text): Syncthing's word for what it's doing: idle, scanning, syncing, sync-waiting, error, paused and so on
- `status` (text): The status as Syncthing's screen shows it: Up to date, Out of sync, Syncing, Scanning, Paused, Stopped, Unshared…
- `synced_everywhere` (true/false): True when this device and every device it's shared with have it all
- `type` (text): Send & Receive, Send Only, Receive Only or Receive Encrypted
- `up_to_date` (true/false): True when this device has every file and none failed to sync

**Example output**

```json
{
  "completion": 100.0,
  "devices": [
    {
      "completion": 100.0,
      "connected": true,
      "device_id": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
      "name": "Laptop",
      "need_bytes": 0,
      "need_items": 0
    }
  ],
  "error": "",
  "errors": 0,
  "folder_id": "docs-lodol",
  "global_bytes": 734003200,
  "global_files": 1284,
  "label": "Documents",
  "last_file": "reports/r1.txt",
  "last_file_at": "2026-11-09T19:47:15Z",
  "last_file_deleted": false,
  "last_scan": "2026-11-09T19:47:04Z",
  "local_files": 1284,
  "need_bytes": 0,
  "need_items": 0,
  "need_size": "0 B",
  "path": "/data1/documents",
  "paused": false,
  "shared_with": [
    "Laptop"
  ],
  "size": "700.0 MiB",
  "state": "idle",
  "status": "Up to date",
  "synced_everywhere": true,
  "type": "Send & Receive",
  "up_to_date": true
}
```

### Get system status

Get Syncthing's version, how long it has been running, how many folders and devices it has and how many are connected, and its recent errors. For a health check.

**Inputs**: None.

**Outputs**

- `device_id` (text): This device's ID
- `device_name` (text): This device's name
- `devices` (number): How many remote devices it knows
- `devices_connected` (number): Of those, how many are connected now
- `error_count` (number): How many recent errors Syncthing reports
- `errors` (list): Syncthing's recent errors, as its screen shows them
- `folders` (number): How many folders it syncs
- `folders_paused` (number): Of those, how many are paused
- `os` (text): The operating system it runs on
- `started_at` (text): When Syncthing last started (ISO 8601, UTC)
- `uptime` (text): How long it has been running, in words
- `uptime_seconds` (number): Seconds since it started
- `version` (text): Syncthing's version, such as v2.1.7

**Example output**

```json
{
  "device_id": "W35BERK-BLUPDCW-3CCUCD3-5BUUQXC-GEXA7EG-6O7E4BG-4LVOKXF-RQR64AS",
  "device_name": "Office server",
  "devices": 1,
  "devices_connected": 1,
  "error_count": 1,
  "errors": [
    {
      "message": "Failed initial scan (error=\"folder path missing\")",
      "time": "2026-11-09T19:46:35Z"
    }
  ],
  "folders": 2,
  "folders_paused": 0,
  "os": "linux",
  "started_at": "2026-11-09T19:45:56Z",
  "uptime": "1 day, 2 hours",
  "uptime_seconds": 93784,
  "version": "v2.1.7"
}
```

### List devices

List the remote devices this Syncthing syncs with: connected or not, when last seen, paused, and how much of their folders they have.

**Inputs**: None.

**Outputs**

- `connected` (number): Of those, how many are connected
- `count` (number): How many remote devices are listed
- `devices` (list): Every remote device, by name

**Example output**

```json
{
  "connected": 1,
  "count": 1,
  "devices": [
    {
      "address": "192.168.1.40:22000",
      "client_version": "v2.1.7",
      "completion": 100.0,
      "connected": true,
      "device_id": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
      "folders": [
        "Documents",
        "Photos"
      ],
      "last_seen": "2026-11-09T19:46:55Z",
      "name": "Laptop",
      "need_bytes": 0,
      "need_size": "0 B",
      "paused": false
    }
  ]
}
```

### List folder errors

List the files that won't sync, and why (such as permission denied), in one folder or all of them, and any folder that has stopped.

**Inputs**

- Folder (`folder`, text): Only this folder. Leave blank for every folder.

**Outputs**

- `count` (number): How many files failed to sync
- `errors` (list): The files that failed to sync, and why
- `stopped_count` (number): How many folders stopped with an error
- `stopped_folders` (list): Folders that stopped altogether, and why

**Example output**

```json
{
  "count": 1,
  "errors": [
    {
      "error": "syncing: opening temp file: permission denied",
      "folder_id": "docs-lodol",
      "folder_label": "Documents",
      "path": "locked/x.txt"
    }
  ],
  "stopped_count": 0,
  "stopped_folders": []
}
```

### List folders

List every folder Syncthing syncs, with its status (up to date, syncing, paused…), how much is done, what's left and any errors.

**Inputs**: None.

**Outputs**

- `count` (number): How many folders are listed
- `folders` (list): Every folder, by label
- `up_to_date` (number): Of those, how many are up to date

**Example output**

```json
{
  "count": 2,
  "folders": [
    {
      "completion": 100.0,
      "error": "",
      "errors": 0,
      "folder_id": "docs-lodol",
      "global_bytes": 734003200,
      "global_files": 1284,
      "label": "Documents",
      "local_files": 1284,
      "need_bytes": 0,
      "need_items": 0,
      "need_size": "0 B",
      "path": "/data1/documents",
      "paused": false,
      "shared_with": [
        "Laptop"
      ],
      "size": "700.0 MiB",
      "state": "idle",
      "status": "Up to date",
      "type": "Send & Receive",
      "up_to_date": true
    },
    {
      "completion": 62.5,
      "error": "",
      "errors": 0,
      "folder_id": "photos-lodol",
      "global_bytes": 734003200,
      "global_files": 1284,
      "label": "Photos",
      "local_files": 1284,
      "need_bytes": 402653184,
      "need_items": 214,
      "need_size": "384.0 MiB",
      "path": "/data1/photos",
      "paused": false,
      "shared_with": [
        "Laptop"
      ],
      "size": "700.0 MiB",
      "state": "syncing",
      "status": "Syncing",
      "type": "Send & Receive",
      "up_to_date": false
    }
  ],
  "up_to_date": 1
}
```

### List pending requests

List the devices asking to connect to this Syncthing and the folders other devices offer to share, waiting to be accepted.

**Inputs**: None.

**Outputs**

- `device_count` (number): How many devices are asking to connect
- `devices` (list): Devices asking to connect to this one
- `folder_count` (number): How many folder shares are waiting
- `folders` (list): Folders other devices offer to share, one row per device offering

**Example output**

```json
{
  "device_count": 1,
  "devices": [
    {
      "address": "192.168.1.52:22000",
      "asked_at": "2026-11-09T20:02:11Z",
      "device_id": "P56IOI7-MZJNU2Y-IQGDREY-DM2MGTI-MGL3BXN-PQ6W5BM-TBBZ4TJ-XZWICQ2",
      "name": "Phone"
    }
  ],
  "folder_count": 1,
  "folders": [
    {
      "encrypted": false,
      "folder_id": "music-lodol",
      "label": "Music",
      "offered_at": "2026-11-09T19:51:17Z",
      "offered_by": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
      "offered_by_name": "Laptop"
    }
  ]
}
```

### List recent changes

List files recently added, changed or deleted, newest first: in a folder, made here or on another device, matching a path. From the last 1000 changes Syncthing remembers since it started.

**Inputs**

- Folder (`folder`, text): Only this folder. Leave blank for every folder.
- Made on (`made_on`, text): Only changes made on this device, or only those synced from another device. One of: `any`, `local` (This device), `remote` (Another device). Default: `any`.
- Change (`change`, text): Only files added or changed, or only files deleted. One of: `any`, `changed` (Added or changed), `deleted`. Default: `any`.
- Path (`path`, text): Only matching files: *.pdf for a kind of file anywhere, invoices/ for a subfolder, or invoices/*.pdf.
- How many (`limit`, number): The most to list. Defaults to 25. From 1 to 100.

**Outputs**

- `changes` (list): The changes, newest first
- `count` (number): How many changes are listed
- `total` (number): How many match, of the changes Syncthing remembers

**Example output**

```json
{
  "changes": [
    {
      "change": "changed",
      "event_id": 7,
      "folder_id": "docs-lodol",
      "folder_label": "Documents",
      "item_type": "file",
      "made_by": "Laptop",
      "made_on": "remote",
      "path": "invoices/march.pdf",
      "time": "2026-11-09T19:51:54Z"
    }
  ],
  "count": 1,
  "total": 1
}
```

### Pause device

Pause a remote device, so this Syncthing stops syncing with it until it's resumed.

**Inputs**

- Device (`device`, text, required): The remote device: its name or device ID.

**Outputs**

- `address` (text): The address it's connected from; empty when it isn't
- `changed` (true/false): False when it was already paused (or already running)
- `client_version` (text): Its Syncthing version, while connected
- `connected` (true/false): True while it's connected
- `device_id` (text): The device's ID
- `folders` (list): The folders shared with it, by label
- `last_seen` (text): When it was last connected (ISO 8601, UTC); empty for never
- `name` (text): The device's name
- `paused` (true/false): True while it's paused

**Example output**

```json
{
  "address": "",
  "changed": true,
  "client_version": "v2.1.7",
  "connected": false,
  "device_id": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
  "folders": [
    "Documents",
    "Photos"
  ],
  "last_seen": "2026-11-09T19:46:55Z",
  "name": "Laptop",
  "paused": true
}
```

### Pause folder

Pause a folder on this device, so it stops syncing until it's resumed, as its Pause button does.

**Inputs**

- Folder (`folder`, text, required): The folder: its label or folder ID.

**Outputs**

- `changed` (true/false): False when it was already paused (or already running)
- `completion` (number): How much of the folder this device has, in percent
- `error` (text): Why the folder stopped, when it did; empty otherwise
- `errors` (number): Files that failed to sync
- `folder_id` (text): The folder's ID, the same on every device
- `global_bytes` (number): The folder's size in bytes
- `global_files` (number): Files in the folder, across all devices
- `label` (text): The folder's label, as Syncthing shows it
- `local_files` (number): Files this device has
- `need_bytes` (number): Bytes this device still needs
- `need_items` (number): Files and folders this device still needs
- `need_size` (text): The same, in words, such as 1.2 MiB
- `path` (text): Where the folder is on this device
- `paused` (true/false): True while the folder is paused
- `shared_with` (list): The other devices it's shared with, by name
- `size` (text): The folder's size in words, such as 4.5 GiB
- `state` (text): Syncthing's word for what it's doing: idle, scanning, syncing, sync-waiting, error, paused and so on
- `status` (text): The status as Syncthing's screen shows it: Up to date, Out of sync, Syncing, Scanning, Paused, Stopped, Unshared…
- `type` (text): Send & Receive, Send Only, Receive Only or Receive Encrypted
- `up_to_date` (true/false): True when this device has every file and none failed to sync

**Example output**

```json
{
  "changed": true,
  "completion": 100.0,
  "error": "",
  "errors": 0,
  "folder_id": "docs-lodol",
  "global_bytes": 734003200,
  "global_files": 1284,
  "label": "Documents",
  "local_files": 1284,
  "need_bytes": 0,
  "need_items": 0,
  "need_size": "0 B",
  "path": "/data1/documents",
  "paused": true,
  "shared_with": [
    "Laptop"
  ],
  "size": "700.0 MiB",
  "state": "paused",
  "status": "Paused",
  "type": "Send & Receive",
  "up_to_date": false
}
```

### Rescan folder

Scan a folder (or one subfolder) for changes now, such as after a workflow saved files into it, so they sync straight away. Waits for the scan, up to 5 minutes.

**Inputs**

- Folder (`folder`, text, required): The folder: its label or folder ID.
- Subfolder (`subfolder`, text): Only this subfolder, as a path inside the folder, such as invoices/2026. Leave blank for the whole folder.

**Outputs**

- `completion` (number): How much of the folder this device has, in percent
- `error` (text): Why the folder stopped, when it did; empty otherwise
- `errors` (number): Files that failed to sync
- `finished` (true/false): True when the scan finished; false when it's still running in Syncthing
- `folder_id` (text): The folder's ID, the same on every device
- `global_bytes` (number): The folder's size in bytes
- `global_files` (number): Files in the folder, across all devices
- `label` (text): The folder's label, as Syncthing shows it
- `local_files` (number): Files this device has
- `need_bytes` (number): Bytes this device still needs
- `need_items` (number): Files and folders this device still needs
- `need_size` (text): The same, in words, such as 1.2 MiB
- `path` (text): Where the folder is on this device
- `paused` (true/false): True while the folder is paused
- `shared_with` (list): The other devices it's shared with, by name
- `size` (text): The folder's size in words, such as 4.5 GiB
- `state` (text): Syncthing's word for what it's doing: idle, scanning, syncing, sync-waiting, error, paused and so on
- `status` (text): The status as Syncthing's screen shows it: Up to date, Out of sync, Syncing, Scanning, Paused, Stopped, Unshared…
- `subfolder` (text): The subfolder scanned; empty for the whole folder
- `type` (text): Send & Receive, Send Only, Receive Only or Receive Encrypted
- `up_to_date` (true/false): True when this device has every file and none failed to sync

**Example output**

```json
{
  "completion": 100.0,
  "error": "",
  "errors": 0,
  "finished": true,
  "folder_id": "docs-lodol",
  "global_bytes": 734003200,
  "global_files": 1284,
  "label": "Documents",
  "local_files": 1284,
  "need_bytes": 0,
  "need_items": 0,
  "need_size": "0 B",
  "path": "/data1/documents",
  "paused": false,
  "shared_with": [
    "Laptop"
  ],
  "size": "700.0 MiB",
  "state": "idle",
  "status": "Up to date",
  "subfolder": "reports",
  "type": "Send & Receive",
  "up_to_date": true
}
```

### Resume device

Resume a paused remote device, so they sync again.

**Inputs**

- Device (`device`, text, required): The remote device: its name or device ID.

**Outputs**

- `address` (text): The address it's connected from; empty when it isn't
- `changed` (true/false): False when it was already paused (or already running)
- `client_version` (text): Its Syncthing version, while connected
- `connected` (true/false): True while it's connected
- `device_id` (text): The device's ID
- `folders` (list): The folders shared with it, by label
- `last_seen` (text): When it was last connected (ISO 8601, UTC); empty for never
- `name` (text): The device's name
- `paused` (true/false): True while it's paused

**Example output**

```json
{
  "address": "192.168.1.40:22000",
  "changed": true,
  "client_version": "v2.1.7",
  "connected": true,
  "device_id": "ZTONLZR-2L5PTUE-5F6BNH2-M4G7JEP-ZXKQT25-6LBI3A7-TMIYY6J-NRBOMAL",
  "folders": [
    "Documents",
    "Photos"
  ],
  "last_seen": "2026-11-09T19:46:55Z",
  "name": "Laptop",
  "paused": false
}
```

### Resume folder

Resume a paused folder, so it syncs again.

**Inputs**

- Folder (`folder`, text, required): The folder: its label or folder ID.

**Outputs**

- `changed` (true/false): False when it was already paused (or already running)
- `completion` (number): How much of the folder this device has, in percent
- `error` (text): Why the folder stopped, when it did; empty otherwise
- `errors` (number): Files that failed to sync
- `folder_id` (text): The folder's ID, the same on every device
- `global_bytes` (number): The folder's size in bytes
- `global_files` (number): Files in the folder, across all devices
- `label` (text): The folder's label, as Syncthing shows it
- `local_files` (number): Files this device has
- `need_bytes` (number): Bytes this device still needs
- `need_items` (number): Files and folders this device still needs
- `need_size` (text): The same, in words, such as 1.2 MiB
- `path` (text): Where the folder is on this device
- `paused` (true/false): True while the folder is paused
- `shared_with` (list): The other devices it's shared with, by name
- `size` (text): The folder's size in words, such as 4.5 GiB
- `state` (text): Syncthing's word for what it's doing: idle, scanning, syncing, sync-waiting, error, paused and so on
- `status` (text): The status as Syncthing's screen shows it: Up to date, Out of sync, Syncing, Scanning, Paused, Stopped, Unshared…
- `type` (text): Send & Receive, Send Only, Receive Only or Receive Encrypted
- `up_to_date` (true/false): True when this device has every file and none failed to sync

**Example output**

```json
{
  "changed": true,
  "completion": 100.0,
  "error": "",
  "errors": 0,
  "folder_id": "docs-lodol",
  "global_bytes": 734003200,
  "global_files": 1284,
  "label": "Documents",
  "local_files": 1284,
  "need_bytes": 0,
  "need_items": 0,
  "need_size": "0 B",
  "path": "/data1/documents",
  "paused": false,
  "shared_with": [
    "Laptop"
  ],
  "size": "700.0 MiB",
  "state": "idle",
  "status": "Up to date",
  "type": "Send & Receive",
  "up_to_date": true
}
```
