Files

GET /api/files/project

Lists files and subdirectories in the currently loaded project's directory.

Parameters:

Parameter	Required	Description
`path`	No	Relative subdirectory path within the project directory

Response: 200 OK — JSON array of file/directory entries:

[
  {
    "name": "background.png",
    "fullPath": "C:\\Projects\\MyProject\\background.png",
    "size": 204800,
    "lastModified": "2026-04-18T10:30:00Z",
    "isDirectory": false
  },
  {
    "name": "Assets",
    "fullPath": "C:\\Projects\\MyProject\\Assets",
    "size": 0,
    "lastModified": "2026-04-17T08:00:00Z",
    "isDirectory": true
  }
]

Errors:

400 Bad Request — No project loaded, or path attempts directory traversal
404 Not Found — Directory does not exist

GET /api/files/media

Lists files and subdirectories in the configured media directory.

Parameters:

Parameter	Required	Description
`path`	No	Relative subdirectory path within the media directory

Response: Same format as /api/files/project.

Errors:

400 Bad Request — Directory not configured, or path attempts directory traversal
404 Not Found — Directory does not exist

GET /api/files/video

Lists files and subdirectories in the configured video directory.

Parameters:

Parameter	Required	Description
`path`	No	Relative subdirectory path within the video directory

Response: Same format as /api/files/project.

Errors:

400 Bad Request — Directory not configured, or path attempts directory traversal
404 Not Found — Directory does not exist

GET /api/files/images

Lists files and subdirectories in the configured images directory.

Parameters:

Parameter	Required	Description
`path`	No	Relative subdirectory path within the images directory

Response: Same format as /api/files/project.

Errors:

400 Bad Request — Directory not configured, or path attempts directory traversal
404 Not Found — Directory does not exist