> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List watched folders

> The folders someone linked, as opposed to the documents inside them. Adding a folder
creates one document per file and would otherwise forget the folder itself, which is the
only record that files arriving LATER were asked for too.

`enabled` is false when the daemon has watching switched off (`MEMLOOM_SYNC=off`).
"Nothing is watched" and "watching is off" are different answers, and a client that
cannot tell them apart will report the wrong one.




## OpenAPI

````yaml /openapi.yaml get /context/roots
openapi: 3.1.0
info:
  title: memloom local API
  version: 0.1.0
  description: >
    The HTTP API served by the `memloom serve` daemon on your machine. The CLI,
    the MCP server,

    and the viewer all route through this API. The daemon is the single owner of
    the store, so

    every client shares one consistent view of your memories.


    No authentication: the daemon binds to `127.0.0.1` only and is reachable
    solely from your

    own machine. Browser clients on other localhost ports are allowed via CORS.
servers:
  - url: http://127.0.0.1:4319
    description: Local memloom daemon
security: []
paths:
  /context/roots:
    get:
      summary: List watched folders
      description: >
        The folders someone linked, as opposed to the documents inside them.
        Adding a folder

        creates one document per file and would otherwise forget the folder
        itself, which is the

        only record that files arriving LATER were asked for too.


        `enabled` is false when the daemon has watching switched off
        (`MEMLOOM_SYNC=off`).

        "Nothing is watched" and "watching is off" are different answers, and a
        client that

        cannot tell them apart will report the wrong one.
      operationId: listContextRoots
      responses:
        '200':
          description: Linked folders, newest first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  enabled:
                    type: boolean
                    description: The daemon is watching. False under MEMLOOM_SYNC=off.
                  roots:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        path:
                          type: string
                        watching:
                          type: boolean
                        documents:
                          type: integer
                          description: >-
                            Documents in the store whose path sits under this
                            root.
                        lastScanAt:
                          type: string
                          format: date-time
                          nullable: true
                          description: >
                            The catch-up watermark. A rescan only reads entries
                            modified since

                            this, plus anything the store has never seen.
                        createdAt:
                          type: string
                          format: date-time
                  stats:
                    type: object
                    description: Present only while watching is enabled.
                    properties:
                      roots:
                        type: integer
                      files:
                        type: integer
                        description: >-
                          Files watched individually, outside any watched
                          folder.
                      queued:
                        type: integer
                        description: >-
                          Paths handed to the ingest queue since the daemon
                          started.
                      missing:
                        type: integer
                        description: Documents marked missing since the daemon started.
                      capped:
                        type: boolean
                        description: The last rescan hit the walk cap.

````