MOmosaic
Pipeline Observability

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.

get/storage_trigger/{trigger_id}/folders

Request

  • Base URL
    https://api.mosaic.so
  • URL
    https://api.mosaic.so/storage_trigger/{trigger_id}/folders
  • Auth
    HTTP bearer

Path parameters

trigger_idstring uuid required

trigger id UUID.

Query parameters

limitinteger

Page size from 1 to 100; default 25. Progress and notification configuration pages count tiles.

cursorstring

Opaque next_cursor from the previous page. Pass verbatim and preserve the original filters. Do not decode or construct it.

fromstring date-time

Inclusive ISO 8601 lower bound on creation time.

tostring date-time

Inclusive ISO 8601 upper bound on creation time.

updated_fromstring date-time

Inclusive ISO 8601 update watermark. Restart pagination on each poll and fetch every page before advancing it.

workspace_idstring uuid

Optional workspace UUID within the key organization. Must match X-Workspace-Id when both are supplied.

folder_idstring

Provider parent folder ID for event/folder queries; batches use batch_folder_node_id.

activeboolean

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

Headers

X-Workspace-Idstring uuid

Restrict requests to an authorized workspace UUID. Omit to query the organization.

Response

Current organization-scoped evidence.

next_cursorstring nullable

Opaque cursor for the next page; null at the end.

trigger_idstring uuid

Requested storage trigger ID.

Changes

No recorded changes to this operation across all 1 revision of this API.