Directory Monitor

The Directory Monitor API enables real-time synchronization and event orchestration for local filesystem changes. It is designed for deep integration with local agents to monitor project directories, capture file events, and trigger remote workflows.

Initialize Monitor (Startup)

Signal the start of a monitoring session for a specific project. This initialization step validates the project configuration and prepares the environment for ingress events.

{
  "ingressToken": "DM_SECURE_TOKEN_XYZ"
}

{
  "status": "success",
  "projectId": "proj_123"
}

Synchronize Event (Ingress)

Report a filesystem event (creation, modification, deletion) to the centralized monitor. This endpoint processes file metadata and executes any associated workflow triggers.

{
  "projectId": "proj_123",
  "filename": "src/controllers/UserController.php",
  "event": "modified",
  "filesize": 4096,
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "uid": 1000,
  "pid": 4512
}

{
  "status": "success",
  "eventId": "evt_7721...",
  "projectId": "proj_123",
  "inserted": true,
  "workflowTriggered": true
}

Audit Monitor Events

Retrieve a paginated history of synchronized filesystem events for a specific project. This is used for auditing changes and verifying synchronization state.

{
  "status": "fetch",
  "projectId": "proj_123",
  "page": 1,
  "size": 50,
  "count": 120,
  "items": []
}