API Reference workspaces

Start a batch upload

POST/projects/{project_id}/workspace/upload/batch/start

Register a multi-file upload against the storage quota; returns the upload_id the file legs attach to.

Parameters

Body fieldRequiredDescription
pathyesDestination directory
filesyesArray of {name, size} entries, one per file
wsnoWorkspace UUID — defaults to the project default workspace

Request

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/workspace/upload/batch/start" \
  -H "Authorization: Bearer $TASK_JWT" \
  -H "Content-Type: application/json"
  -d '{"path": "/reports", "files": [{"name": "a.csv", "size": 1024}]}'