listDocuments

List AND grep documents in a project, workspace, or folder. query does a full-content search across each document's body (not just the title) and returns the matching lines — like grep across your docs. Each returned document includes contentMatches: [{line, text, context?}] and matchCount; the text is anchor-ready (paste it straight into editDocument's oldText). Use isRegex:true for regular-expression search (e.g. "TODO(.*)", "ACME-\d+"), caseSensitive for exact case, and contextLines for surrounding lines (grep -C). versionTimestamp is returned per document so you can edit straight from the results without a getDocument round-trip. Also supports date filtering. SCOPE HONESTY — read this before concluding something is absent: only documents that actually matched are returned (a document is never listed with matchCount 0 just because it was in scope), and the grep block reports scannedDocuments against totalDocumentsInScope. When truncated is true the search covered only part of the scope, so an absence is NOT proof; repeat with scanOffset set to the returned nextScanOffset until that field is gone, and union the results. A document too large to read is returned with contentSearchSkipped: true and NO matchCount, because its body was never searched.