Roam Research

roam_search_by_status

Search for blocks with a specific status (TODO/DONE) across all pages or within a specific page.

Input Schema

NameRequiredDescriptionDefault
excludeNoOptional: Comma-separated list of terms to filter results by exclusion (matches content or page title)
includeNoOptional: Comma-separated list of terms to filter results by inclusion (matches content or page title)
page_title_uidNoOptional: Title or UID of the page to search in. If not provided, searches across all pages
statusYesStatus to search for (TODO or DONE)

Input Schema (JSON Schema)

{ "properties": { "exclude": { "description": "Optional: Comma-separated list of terms to filter results by exclusion (matches content or page title)", "type": "string" }, "include": { "description": "Optional: Comma-separated list of terms to filter results by inclusion (matches content or page title)", "type": "string" }, "page_title_uid": { "description": "Optional: Title or UID of the page to search in. If not provided, searches across all pages", "type": "string" }, "status": { "description": "Status to search for (TODO or DONE)", "enum": [ "TODO", "DONE" ], "type": "string" } }, "required": [ "status" ], "type": "object" }