---
title: "Changes to Upload dataset from JSON, JSONL, CSV, or PyArrow"
method: POST
path: "/v1/datasets/upload"
---

# Changes to Upload dataset from JSON, JSONL, CSV, or PyArrow

`POST /v1/datasets/upload`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 70 revisions.

- **2026-04-29** `02361ac1935f` — 8 info
- **2026-04-29** `c81391216eb5` — 5 breaking, 3 warning

## Changes

- **2026-04-29** `02361ac1935f` — 8 info
  - added the new optional request property `example_id_key` (media type: multipart/form-data)
  - added the new optional request property `example_ids` (media type: application/json)
  - added the new optional request property `split_key` (media type: multipart/form-data)
  - added the new `update` enum value to the request property `action` (media type: application/json)
  - added the new `update` enum value to the request property `action` (media type: multipart/form-data)
  - added the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_created_examples` to the response with the `200` status
  - added the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_deleted_examples` to the response with the `200` status
  - added the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_updated_examples` to the response with the `200` status
- **2026-04-29** `c81391216eb5` — 5 breaking, 3 warning
  - removed the enum value `update` of the request property `action` (media type: application/json)
  - removed the enum value `update` of the request property `action` (media type: multipart/form-data)
  - removed the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_created_examples` from the response with the `200` status
  - removed the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_deleted_examples` from the response with the `200` status
  - removed the required property `anyOf[subschema #1: UploadDatasetResponseBody]/data/num_updated_examples` from the response with the `200` status
  - removed the request property `example_id_key` (media type: multipart/form-data)
  - removed the request property `example_ids` (media type: application/json)
  - removed the request property `split_key` (media type: multipart/form-data)

---

[Operation](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/docs/v1/datasets/upload/post.md) · [API](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api.md) · [Page](https://skmtc.dev/arize-ai/apis/arize-phoenix-rest-api/changes/v1/datasets/upload/post)