API Reference workspaces

Upload a file

POST/projects/{project_id}/workspace/upload/batch/{upload_id}/file

Upload one file leg of a batch (multipart, index matches the start manifest). In knowledge-base workspaces non-Markdown files convert to Markdown automatically.

Parameters

Form field	Required	Description
file	yes	The file payload
index	yes	Position in the start manifest’s files array

Request

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/workspace/upload/batch/$UPLOAD_ID/file" \
  -H "Authorization: Bearer $TASK_JWT" \
  -H "Content-Type: application/json"
  -F "file=@policy.pdf" -F "index=0"