---
title: "Changes to Create dataset"
method: POST
path: "/v1/dataset"
---

# Changes to Create dataset

`POST /v1/dataset`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 101 revisions.

- **2026-10-30** `8f5039399f77`: 4 breaking
- **2026-09-03** `ebac33c1422e`: 1 breaking
- **2026-04-08** `a21b724fece9`: 2 info
- **2026-01-08** `c7496daaaa37`: 1 info
- **2025-06-17** `77a2d5797d94`: 1 breaking, 1 info
- **2024-09-30** `ac2727014d93`: 8 breaking, 1 info
- **2024-07-23** `9eeeeb30b963`: 2 info
- **2024-05-06** `44b51ad3239a`: 5 breaking, 7 info

## Changes

- **2026-10-30** `8f5039399f77`: 4 breaking
  - the request property `description` became not nullable
  - the request property `metadata` became not nullable
  - the request property `metadata/additionalProperties/` became not nullable
  - the request property `tags` became not nullable
- **2026-09-03** `ebac33c1422e`: 1 breaking
  - request body became required
- **2026-04-08** `a21b724fece9`: 2 info
  - added the new optional request property `tags`
  - added the optional property `tags` to the response with the `200` status
- **2026-01-08** `c7496daaaa37`: 1 info
  - added the required property `url_slug` to the response with the `200` status
- **2025-06-17** `77a2d5797d94`: 1 breaking, 1 info
  - the `name` request property's minLength was increased from `0` to `1`
  - added the new optional request property `metadata`
- **2024-09-30** `ac2727014d93`: 8 breaking, 1 info
  - the request property `project_id` became not nullable
  - the request property `project_id` became required
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response's body became nullable
  - the response property `metadata/additionalProperties/` became nullable for the status `200`
  - the response property `project_id` became required for the status `200`
- **2024-07-23** `9eeeeb30b963`: 2 info
  - request body became optional
  - added the optional property `metadata` to the response with the `200` status
- **2024-05-06** `44b51ad3239a`: 5 breaking, 7 info
  - the response property `created` became nullable for the status `200`
  - the response property `deleted_at` became nullable for the status `200`
  - the response property `description` became nullable for the status `200`
  - the response property `project_id` became nullable for the status `200`
  - the response property `user_id` became nullable for the status `200`
  - the request property `description` became nullable
  - the request property `project_id` became nullable
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the media type `application/json` for the response with the status `500`
  - added the non-success response with the status `429`

---

[Operation](https://skmtc.dev/braintrustdata/apis/braintrust-api/docs/v1/dataset/post.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/dataset/post)