Create a new dataset from an uploaded file

Create a new dataset from an uploaded file (CSV, JSON, JSONL) upload the file as a stored object with the purpose dataset_import, then create the dataset from it

POST /api/v1/dataset/upload

Python

Python

import requests

url = "https://app.langwatch.ai/api/v1/dataset/upload"

files = { "file": ("example-file", open("example-file", "rb")) }
payload = { "name": "<string>" }
headers = {"X-Auth-Token": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

201

{
  "id": "<string>",
  "name": "<string>",
  "slug": "<string>",
  "columnTypes": [
    {
      "name": "<string>",
      "type": "string"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "recordsCreated": 4503599627370495
}

Authorizations

X-Auth-Token · string · header · required

Project API key for sending traces and accessing project-scoped resources. Format: sk-lw-... (no underscore). Obtain one by creating a project via the Admin API or the LangWatch UI.

Body

multipart/form-data

name · string · required

Minimum string length: 1

file · file · required

Response

201 - application/json

Success

id · string · required

name · string · required

slug · string · required

columnTypes · object[] · required

Show child attributes

createdAt · string<date-time> · required

updatedAt · string<date-time> · required

recordsCreated · integer · required

Required range: 0 <= x <= 9007199254740991