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

# Index sessions (persistent run history)

> Every index/reindex pass is recorded as a run: trigger (index|rebuild), status
(running|success|warning|error|interrupted), batch size, per-kind indexed counts,
failures, and entity/relation totals. Newest first. The viewer's Console polls this
while a run is live; history survives restarts and includes CLI runs.




## OpenAPI

````yaml /openapi.yaml get /memory/index/runs
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:
  /memory/index/runs:
    get:
      summary: Index sessions (persistent run history)
      description: >
        Every index/reindex pass is recorded as a run: trigger (index|rebuild),
        status

        (running|success|warning|error|interrupted), batch size, per-kind
        indexed counts,

        failures, and entity/relation totals. Newest first. The viewer's Console
        polls this

        while a run is live; history survives restarts and includes CLI runs.
      operationId: listIndexRuns
      responses:
        '200':
          description: Runs, newest first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  runs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        trigger:
                          type: string
                          enum:
                            - index
                            - rebuild
                        status:
                          type: string
                          enum:
                            - running
                            - success
                            - warning
                            - error
                            - interrupted
                        batchSize:
                          type: integer
                          example: 14
                        memoriesIndexed:
                          type: integer
                        chunksIndexed:
                          type: integer
                        itemsFailed:
                          type: integer
                        entitiesLinked:
                          type: integer
                        relationsCreated:
                          type: integer
                        startedAt:
                          type: string
                          format: date-time
                        finishedAt:
                          type: string
                          format: date-time
                          nullable: true

````