MINARA

Read a workspace file

GET /v1/workspace/files/:name — Return the contents of a single workspace md file plus its sha256. `:name` must be a whitelisted filename (SOUL.md / AGE

GET /v1/workspace/files/:name

Return the contents of a single workspace md file plus its sha256. :name must be a whitelisted filename (SOUL.md / AGENTS.md / IDENTITY.md / USER.md / MEMORY.md / BOOTSTRAP.md / TOOLS.md / HEARTBEAT.md). Path traversal attempts (.., absolute paths, non-whitelisted names) return 404.

MethodGET
Path/v1/workspace/files/:name
AuthAuthorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set
Categoryworkspace

Response body

{ "ok": true, "data": { "name": "SOUL.md", "exists": true, "content": "# SOUL.md - Minara\n...", "sha256": "deadbeef...", "mtime": 1714492800000 } }

On this page