Skip to main content
Nowledge MemNowledge Mem

Fs Cat

GET
/fs/cat

Return the rendered body of a Nowledge FS file.

For .md files this returns YAML-frontmatter markdown. For messages.jsonl it returns one JSON object per line. Fragment selectors (:page/N, :section/<name>, etc.) are documented in the design doc but land in Phase 2; passing one returns ENOTSUP for now. line / lines are Phase 1 progressive-read controls for agents: they work for every rendered text body, including thread messages.jsonl where one line is one message.

Query Parameters

path*Path

Nowledge FS file path

line?|

One-based line to start reading from

lines?|

Number of lines to return

fragment?|

Fragment selector (page|section|sheet|slide|chunk) — Phase 2

raw?Raw

For .source.* files: return original bytes (501 in Phase 1)

Defaultfalse
agent_id?|

Agent identity id/slug for /context/* files

source_app?|

Calling app provenance hint for /context/* files

host_agent_id?|

Host-local long-running agent id for /context/* files

space_id?|

Active space override for /context/* files

include_working_memory?Include Working Memory

Include Working Memory preview in /context/* files

Defaulttrue

Response Body

application/json

application/json

curl -X GET "https://example.com/fs/cat?path=string"
null