List Files GET /api/v1/workspaces/{workspaceId}/storage
all · images · deliverables · documents · files
Filename search (partial match).
image · deliverable · document · file
Human-readable origin label
App ID, run ID, or upload ID that produced this file
Signed S3 URL, valid 15 minutes
Logical path in the workspace tree (type: "file" only)
none · queued · processing · ready · failed
True if this file was imported from GitHub
GitHub repo/branch/commit metadata, if applicable
{ images, deliverables, documents, files } counts
curl "https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/storage?type=documents&limit=20" \ -H "Authorization: Bearer spj_ai_your_api_key_here"
Get File Content GET /api/v1/workspaces/{workspaceId}/storage/content
image · deliverable · document · file
Streams the raw file with Content-Type set to the stored MIME type and Content-Disposition: inline.
curl "https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/storage/content?fileId=file_1&fileType=document" \ -H "Authorization: Bearer spj_ai_your_api_key_here" \ -o downloaded-file.pdf
Move or Rename File PATCH /api/v1/workspaces/{workspaceId}/storage/files/{fileId}
Required when action is move.
Required when action is rename.
curl -X PATCH https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/storage/files/file_1 \ -H "Authorization: Bearer spj_ai_your_api_key_here" \ -H "Content-Type: application/json" \ -d '{ "action": "move", "destFolderPath": "/archive" }'
{ "file" : { "id" : "file_1" , "filename" : "report.pdf" , "path" : "/archive/report.pdf" , "..." : "..." } }
There is also a bulk variant of this operation at PATCH /api/v1/workspaces/{workspaceId}/storage/files — same body shape, plus a top-level fileId field to select the target file.
Errors Status Error 400 fileId is required / destFolderPath is required for move / newName is required for rename400 Missing fileId or fileType (Get Content)401 Unauthorized404 File not found / Storage key not found / Empty file
