POST /api/files

Upload a file.
{
  "scope": "session",
  "scopeId": "sess_abc123",
  "path": "src/main.ts",
  "name": "main.ts",
  "content": "base64-encoded-content",
  "mimeType": "text/typescript",
  "isManaged": true,
  "metadata": {}
}

GET /api/files

List files by scope. Query parameters: scope, scopeId

GET /api/files/:id

Get file metadata.

GET /api/files/:id/content

Get file content.

DELETE /api/files/:id

Delete a file.

GET /api/files/resolve

Resolve a file by path within a scope.

GET /api/sessions/:id/file

Get a file from an active session’s workspace (proxied via Podium, which reads from the agent’s Chronicle FUSE mount).

Skills API

Skills are reusable agent capabilities (custom tools, prompts, integrations).

GET /api/skills

List installed skills.

POST /api/skills

Install a new skill.
{
  "name": "code-review",
  "scope": "tenant",
  "scopeId": "tenant_abc",
  "source": "https://github.com/skills/code-review",
  "version": "1.0.0",
  "content": "skill definition content...",
  "metadata": { "category": "development" }
}

GET /api/skills/:id

Get skill details.

PATCH /api/skills/:id

Enable or disable a skill.
{
  "enabled": true
}

PUT /api/skills/:id/content

Update skill content.
{
  "content": "updated skill definition..."
}

DELETE /api/skills/:id

Uninstall a skill.