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

# Put a folder on the watch list

> Adds a folder to the watch list without ingesting anything. Idempotent by path:
re-adding a folder already on the list turns watching back on rather than making a
second entry.

Every add route records the folder it was given, so this is only needed when nothing is
being ingested. The CLI uses it because it walks a folder itself, to report per-file
progress, and then adds one FILE at a time: nothing it sends would otherwise tell the
daemon a folder was involved.

An EMPTY folder is a normal thing to link. Pointing a recorder at a folder means linking
it before the first file exists.




## OpenAPI

````yaml /openapi.yaml post /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:
    post:
      summary: Put a folder on the watch list
      description: >
        Adds a folder to the watch list without ingesting anything. Idempotent
        by path:

        re-adding a folder already on the list turns watching back on rather
        than making a

        second entry.


        Every add route records the folder it was given, so this is only needed
        when nothing is

        being ingested. The CLI uses it because it walks a folder itself, to
        report per-file

        progress, and then adds one FILE at a time: nothing it sends would
        otherwise tell the

        daemon a folder was involved.


        An EMPTY folder is a normal thing to link. Pointing a recorder at a
        folder means linking

        it before the first file exists.
      operationId: addContextRoot
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - path
              properties:
                path:
                  type: string
                  description: Absolute path of a folder on the machine running memloom.
      responses:
        '200':
          description: On the watch list.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  path:
                    type: string
                  watching:
                    type: boolean
                  documents:
                    type: integer
                  lastScanAt:
                    type: string
                    format: date-time
                    nullable: true
                  createdAt:
                    type: string
                    format: date-time
        '400':
          description: No such path, or the path is a file rather than a folder.

````