BRbraintrustdata
Datasets

Create dataset

Changed on

Create a new dataset. If there is an existing dataset in the project with the same name as the one specified in the request, will return the existing dataset unmodified

post/v1/dataset

Request

  • Base URL
    https://api.braintrust.dev
  • Auth
    • HTTP bearer
    • or none

Request body

project_idstring uuid required

Unique identifier for the project that the dataset belongs under

namestring required

Name of the dataset. Within a project, dataset names are unique

descriptionstring nullable

Textual description of the dataset

tagsstring[] nullable

A list of tags for the dataset

metadataobject nullable

User-controlled metadata about the dataset

Response

Returns the new dataset object

idstring uuid required

Unique identifier for the dataset

project_idstring uuid required

Unique identifier for the project that the dataset belongs under

namestring required

Name of the dataset. Within a project, dataset names are unique

descriptionstring nullable

Textual description of the dataset

createdstring date-time nullable

Date of dataset creation

deleted_atstring date-time nullable

Date of dataset deletion, or null if the dataset is still active

user_idstring uuid nullable

Identifies the user who created the dataset

tagsstring[] nullable

A list of tags for the dataset

metadataobject nullable

User-controlled metadata about the dataset

url_slugstring required

URL slug for the dataset. used to construct dataset URLs

Changes

  • 8f5039399f77Revision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property / became not nullable

    • breaking

      the request property became not nullable

  • ebac33c1422eRevision changes
    • breaking

      request body became required