Files

List files

GET /external/v1/projects/{project_id}/files?path=/&ws=WS_UUID

Read file content

GET /external/v1/projects/{project_id}/files/content?path=/file.md&ws=WS_UUID

Write file

PUT /external/v1/projects/{project_id}/files/content

Body: { "path": "/output/result.md", "content": "# Result\n...", "ws": "WS_UUID" }

Upload file

POST /external/v1/projects/{project_id}/files/upload

Multipart form-data. Files uploaded to a knowledge-base workspace are automatically converted to Markdown (.docx, .pdf, .xlsx, .pptx, and 11 other formats).

curl -X POST http://localhost:8000/external/v1/projects/PROJECT_ID/files/upload \
  -H "Authorization: Bearer API_KEY" \
  -F "file=@report.pdf" \
  -F "dir_path=/documents" \
  -F "ws=KB_WS_UUID"

Delete file

DELETE /external/v1/projects/{project_id}/files?path=/tmp/old.md&ws=WS_UUID