Skip to content
Dashboard
API Reference

List Watched Folders ​

List discovered watched Drive/Dropbox folders, watcher health, last observed event, and errors. Empty last_event_at means no recorded event; it does not prove that a folder contains no files.

Required scope: triggers:read. See API key permissions and the pipeline dashboard guide.

Request ​

bash
curl "https://api.mosaic.so/storage_trigger/22222222-2222-4222-8222-222222222222/folders?limit=25" \
  -H "Authorization: Bearer mk_your_api_key" \
  -H "X-Workspace-Id: 66666666-6666-4666-8666-666666666666"

Workspace IDs and resource IDs above are examples. Use IDs returned by your own API calls.

Parameters ​

ParameterLocationMeaning
limitqueryPage size from 1 to 100; default 25. Progress and notification configuration pages count tiles.
cursorqueryOpaque next_cursor from the previous page. Pass verbatim and preserve the original filters. Do not decode or construct it.
fromqueryInclusive ISO 8601 lower bound on creation time.
toqueryInclusive ISO 8601 upper bound on creation time.
updated_fromqueryInclusive ISO 8601 update watermark. Restart pagination on each poll and fetch every page before advancing it.
workspace_idqueryOptional workspace UUID within the key organization. Must match X-Workspace-Id when both are supplied.
folder_idqueryProvider parent folder ID for event/folder queries; batches use batch_folder_node_id.
trigger_idpathtrigger id UUID.
activequeryOptional subscription activity filter. By default, include inactive subscriptions and soft-deleted watchers with their last health/error state. updated_from matches changes to either the subscription or its shared watcher, and each folder item updated_at is the later timestamp. Folder names come from drive_nodes_cache.
X-Workspace-IdheaderRestrict requests to an authorized workspace UUID. Omit to query the organization.

Response example ​

json
{
  "trigger_id": "22222222-2222-4222-8222-222222222222",
  "folders": [
    {
      "id": "55555555-5555-4555-8555-555555555555",
      "created_at": "2026-10-15T12:00:00Z",
      "updated_at": "2026-10-15T12:01:00Z",
      "depth_from_root": 0,
      "is_active": false,
      "watcher": {
        "id": "55555555-5555-4555-8555-555555555555",
        "folder_id": "drive-folder-7",
        "folder_name": "Production",
        "status": "error",
        "last_event_at": "2026-10-15T12:00:00Z",
        "last_error": "watcher recovery failed",
        "webhook_interval_minutes": 1,
        "updated_at": "2026-10-15T12:01:00Z",
        "deleted_at": null
      }
    }
  ],
  "next_cursor": null
}

Folders values ​

FieldMeaning
idWatcher subscription ID, used internally by pagination.
created_atWatcher subscription creation time.
updated_atLater of subscription.updated_at and watcher.updated_at. updated_from matches either row.
depth_from_rootFolder depth below the selected root.
is_activeWhether this trigger currently watches this folder.
watcher

When next_cursor is non-null, request the next page with the same filters and that cursor. limit defaults to 25 and is capped at 100. Read the polling and error-handling guidance before building a dashboard.