POST
/
v1
/
datasets
/
files
/
upload
curl --request POST \
  --url https://api.roe-ai.com/v1/datasets/files/upload/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=<string>' \
  --form 'dataset_id=<string>' \
  --form 'metadata=<any>'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "dataset": {
    "id": "123e4567-e89b-12d3-a456-426614174001",
    "name": "default",
    "creator": {
      "id": 1,
      "email": "test@roe-ai.com",
      "first_name": "Test",
      "last_name": "Roe",
      "is_active": true
    },
    "created_at": "2024-04-29T14:11:16.688751-07:00"
  },
  "name": "test1.txt",
  "size": 0,
  "creator": {
    "id": 1,
    "email": "test@roe-ai.com",
    "first_name": "Test",
    "last_name": "Roe",
    "is_active": true
  },
  "created_at": "2024-07-01T16:15:51.964998-07:00"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
​
file
string
required

File to upload.

​
dataset_id
string

Dataset ID to upload file to. If not provided, file will be uploaded to default dataset.

Minimum length: 1
​
metadata
any

Optional metadata for the file in JSON format.

Response

200
application/json
File uploaded
​
id
string
required
​
dataset
object
required
​
creator
object
required
​
created_at
string
required
​
name
string | null
Maximum length: 1024
​
size
integer | null
Required range: -9223372036854776000 <= x <= 9223372036854776000