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.
| Method | GET |
| Path | /v1/workspace/files/:name |
| Auth | Authorization: Bearer <token> required when GATEWAY_AUTH_TOKEN is set |
| Category | workspace |
Response body
{ "ok": true, "data": { "name": "SOUL.md", "exists": true, "content": "# SOUL.md - Minara\n...", "sha256": "deadbeef...", "mtime": 1714492800000 } }