v1/Blocks

Get all memory blocks with branch context

Changed on

Retrieves memory blocks from specified Dolt branch with active branch context. Defaults to 'main' branch.

get/api/v1/blocks

Request

  • The document declares no server URL.
  • Auth: none declared

Query parameters

typestring

Filter by block type (e.g., 'project', 'knowledge', 'task')

case_insensitiveboolean

Case-insensitive type filtering

branchstring

Dolt branch to read from (default: 'main')

namespacestring

Filter by namespace (default: 'legacy')

Response

Successful Response

active_branchstring required

Currently active Dolt branch for this operation

requested_branchstring nullable

Branch requested by client (may differ from active_branch for read operations)

timestampstring required

UTC ISO timestamp when the operation was performed

total_countinteger required

Total number of blocks returned

filters_appliedobject nullable

Summary of filters applied (type, case_insensitive, namespace, etc.)

namespace_contextstring nullable

Active namespace used for filtering (when namespace filter applied)

Changes

    • info

      added the new optional query request parameter namespace

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • breaking

      the response's body type changed from array to object for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status