Apps

App file storage — upload files (with optional appId), list, search, and ask agent. APP-SCOPED FILES: pass appId on upload to scope a file to your app. List with appId to see only that app's files; without appId to see workspace/personal files.

• GET/api/v1/workspaces/List apps

  Run
• POST/api/v1/workspaces/Create an app storage area

  Run
• GET/api/v1/workspaces/{workspace_id}Get app details

  Run
• PATCH/api/v1/workspaces/{workspace_id}Update app settings

  Run
• DELETE/api/v1/workspaces/{workspace_id}Delete app storage

  Run
• POST/api/v1/workspaces/files/uploadUpload file(s) — pass appId to scope to your app (multipart form-data)

  Run
• GET/api/v1/workspaces/filesList files — pass appId to list only app-scoped files; omit to see workspace files

  Run
• GET/api/v1/workspaces/files/{file_id}Get file metadata

  Run
• GET/api/v1/workspaces/files/{file_id}/downloadDownload file bytes

  Run
• DELETE/api/v1/workspaces/files/{file_id}Delete file

  Run
• POST/api/v1/workspaces/home/ensureEnsure user home folder exists

  Run

Calls go through the portal proxy with your admin session. SSE (run / generate) endpoints return their final payload here; live streaming lands next.