---
title: "Changes to List datasets"
method: GET
path: "/v1/dataset"
---

# Changes to List datasets

`GET /v1/dataset`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 101 revisions.

- **2026-04-08** `a21b724fece9`: 1 info
- **2026-01-08** `c7496daaaa37`: 1 info
- **2024-09-30** `ac2727014d93`: 6 breaking, 1 info
- **2024-08-08** `344821ebe826`: 1 info
- **2024-07-23** `9eeeeb30b963`: 1 info
- **2024-05-06** `44b51ad3239a`: 5 breaking, 6 info

## Changes

- **2026-04-08** `a21b724fece9`: 1 info
  - added the optional property `objects/items/tags` to the response with the `200` status
- **2026-01-08** `c7496daaaa37`: 1 info
  - added the required property `objects/items/url_slug` to the response with the `200` status
- **2024-09-30** `ac2727014d93`: 6 breaking, 1 info
  - 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 `objects/items/metadata/additionalProperties/` became nullable for the status `200`
  - the response property `objects/items/project_id` became required for the status `200`
- **2024-08-08** `344821ebe826`: 1 info
  - added the new optional `query` request parameter `project_id`
- **2024-07-23** `9eeeeb30b963`: 1 info
  - added the optional property `objects/items/metadata` to the response with the `200` status
- **2024-05-06** `44b51ad3239a`: 5 breaking, 6 info
  - the response property `objects/items/created` became nullable for the status `200`
  - the response property `objects/items/deleted_at` became nullable for the status `200`
  - the response property `objects/items/description` became nullable for the status `200`
  - the response property `objects/items/project_id` became nullable for the status `200`
  - the response property `objects/items/user_id` became nullable for the status `200`
  - added the new optional `query` request parameter `ids`
  - 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/get.md) - [API](https://skmtc.dev/braintrustdata/apis/braintrust-api.md) - [Page](https://skmtc.dev/braintrustdata/apis/braintrust-api/changes/v1/dataset/get)
