Upload File to Folder
1️⃣ Overview
Purpose:
Uploads one or more files into a specific folder within a workspace.
Supports any file type. The target folder is specified via parentId.
2️⃣ Endpoint
POST /noCo/api/v2/workspaces/{workspaceId}/folder/upload
3️⃣ Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| workspaceId | string | ✅ Yes | The ID of the workspace to upload the file into |
4️⃣ Authentication
Requires authentication using:
Authorization: Bearer <token>
5️⃣ Request Headers
| Header | Required |
|---|---|
| Authorization | ✅ Yes |
6️⃣ Request Body (multipart/form-data)
| Field | Type | Required | Description |
|---|---|---|---|
| files | file | ✅ Yes | The file(s) to upload |
| parentId | string | ❌ No | ID of the target folder. If omitted, the file is uploaded to the workspace root |
7️⃣ Example Request
curl --location 'https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/folder/upload' \
--header 'Authorization: Bearer <token>' \
--form 'files=@"/path/to/file"' \
--form 'parentId="{folderId}"'
8️⃣ Behavior Summary
Uploads one or more files into the specified folder within a workspace.
Returns an array of uploaded file objects, each containing the file id, name, type, size, and location metadata.
If parentId is omitted, the file is placed at the workspace root level.
Authorizations
This API uses OAuth 2.0 with the authorization code grant flow.
Path Parameters
Body
Response
Upload File to Folder
Unique identifier of the uploaded file
"dcc00239-8190-4f7e-a2fc-a87448cd121d"
Original filename of the uploaded file
"order_history.csv"
ID of the folder the file was uploaded into
"7b0b1bda-9836-420e-9a0b-6bf3b6bb6e5a"
File extension / format type
"csv"
Size of the uploaded file in bytes
4879
Always false for uploaded files
false
ID of the workspace the file belongs to
"a00140c3-a621-4bd4-a300-00b9ddb1ed26"
ID of the company that owns this file
1
Always empty for files
[]Additional UI-level metadata associated with the file
{}