Folders & Tree

curl "https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/storage/path?folderPath=/archive" \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

{
  "created": true,
  "folder": { "id": "fold_1", "name": "archive", "path": "/archive" }
}

Create Folder

POST /api/v1/workspaces/{workspaceId}/storage/folders

string

required

{
  "created": true,
  "folder": { "id": "fold_1", "name": "archive", "path": "/archive" }
}

Rename Folder

PATCH /api/v1/workspaces/{workspaceId}/storage/folders

string

required

string

required

Browse Path / Tree

GET /api/v1/workspaces/{workspaceId}/storage/path

string

default:"/"

Alias: path.

string

1 — return just the list of folder paths. full — return the entire tree (folders + files).

string

tree is an alias for tree=1.

Response shapes

Default (folder contents)
tree=1 (paths only)
tree=full

{
  "path": "/archive",
  "folders": [ { "id": "fold_2", "name": "2026", "path": "/archive/2026" } ],
  "files": [ /* StorageFile[] — see Files */ ]
}

{ "paths": ["/", "/archive", "/archive/2026", "/uploads"] }

{
  "folders": [ /* all folders */ ],
  "files": [ /* all files */ ]
}

curl "https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/storage/path?folderPath=/archive" \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

Errors

Status	Error
400	`folderPath is required` (Create) / `folderPath and newName are required` (Rename)
401	`Unauthorized`

Chat

Agents

RAG

Artifacts

Image

Vector Store

Apps

Storage

Integrations

Insights

Platform Tools

Create Folder

Rename Folder

Browse Path / Tree

Response shapes

Errors

​Create Folder

​Rename Folder

​Browse Path / Tree

​Response shapes

​Errors

Create Folder

Rename Folder

Browse Path / Tree

Response shapes

Errors