Skip to main content
POST
/
noCo
/
api
/
v2
/
workspaces
/
{workspaceId}
/
folder
/
upload
Upload File to Folder
curl --request POST \
  --url https://be.datagol.ai/noCo/api/v2/workspaces/{workspaceId}/folder/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form files='@example-file' \
  --form parentId=7b0b1bda-9836-420e-9a0b-6bf3b6bb6e5a
[
  {
    "id": "dcc00239-8190-4f7e-a2fc-a87448cd121d",
    "name": "order_history.csv",
    "parentId": "7b0b1bda-9836-420e-9a0b-6bf3b6bb6e5a",
    "type": "csv",
    "byteSize": 4879,
    "isFolder": false,
    "workspaceId": "a00140c3-a621-4bd4-a300-00b9ddb1ed26",
    "companyId": 1,
    "children": [],
    "uiMetadata": {}
  }
]

Authorizations

Authorization
string
header
required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

workspaceId
string
required

Body

multipart/form-data
files
file
required

The file(s) to upload

parentId
string

ID of the folder to upload the file into. If omitted, the file is uploaded to the workspace root

Example:

"7b0b1bda-9836-420e-9a0b-6bf3b6bb6e5a"

Response

200 - application/json

Upload File to Folder

id
string

Unique identifier of the uploaded file

Example:

"dcc00239-8190-4f7e-a2fc-a87448cd121d"

name
string

Original filename of the uploaded file

Example:

"order_history.csv"

parentId
string

ID of the folder the file was uploaded into

Example:

"7b0b1bda-9836-420e-9a0b-6bf3b6bb6e5a"

type
string

File extension / format type

Example:

"csv"

byteSize
integer

Size of the uploaded file in bytes

Example:

4879

isFolder
boolean

Always false for uploaded files

Example:

false

workspaceId
string

ID of the workspace the file belongs to

Example:

"a00140c3-a621-4bd4-a300-00b9ddb1ed26"

companyId
integer

ID of the company that owns this file

Example:

1

children
any[]

Always empty for files

Example:
[]
uiMetadata
object

Additional UI-level metadata associated with the file

Example:
{}