BRbraintrustdata
Experiments

Create experiment

Changed on

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

post/v1/experiment

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 experiment belongs under

namestring nullable

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

descriptionstring nullable

Textual description of the experiment

base_exp_idstring uuid nullable

Id of default base experiment to compare against when viewing this experiment

dataset_idstring uuid nullable

Identifier of the linked dataset, or null if the experiment is not linked to a dataset

dataset_versionstring nullable

Version number of the linked dataset the experiment was run against. This can be used to reproduce the experiment after the dataset has been modified.

parameters_idstring uuid nullable

Identifier of the linked saved parameters object, or null if the experiment is not linked to saved parameters

parameters_versionstring nullable

Version number of the linked saved parameters object the experiment was run against.

publicboolean nullable

Whether or not the experiment is public. Public experiments can be viewed by anybody inside or outside the organization

metadataobject nullable

User-controlled metadata about the experiment

tagsstring[] nullable

A list of tags for the experiment

ensure_newboolean nullable

Normally, creating an experiment with the same name as an existing experiment will return the existing one un-modified. But if ensure_new is true, registration will generate a new experiment with a unique name in case of a conflict.

Response

Returns the new experiment object

idstring uuid required

Unique identifier for the experiment

project_idstring uuid required

Unique identifier for the project that the experiment belongs under

namestring required

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

descriptionstring nullable

Textual description of the experiment

createdstring date-time nullable

Date of experiment creation

commitstring nullable

Commit, taken directly from repo_info.commit

base_exp_idstring uuid nullable

Id of default base experiment to compare against when viewing this experiment

deleted_atstring date-time nullable

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

dataset_idstring uuid nullable

Identifier of the linked dataset, or null if the experiment is not linked to a dataset

dataset_versionstring nullable

Version number of the linked dataset the experiment was run against. This can be used to reproduce the experiment after the dataset has been modified.

parameters_idstring uuid nullable

Identifier of the linked saved parameters object, or null if the experiment is not linked to saved parameters

parameters_versionstring nullable

Version number of the linked saved parameters object the experiment was run against.

publicboolean required

Whether or not the experiment is public. Public experiments can be viewed by anybody inside or outside the organization

user_idstring uuid nullable

Identifies the user who created the experiment

metadataobject nullable

User-controlled metadata about the experiment

tagsstring[] nullable

A list of tags for the experiment

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

    • 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

    • 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

    • 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

    • 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

    • 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

    • breaking

      the request property / became not nullable

    • breaking

      the request property became not nullable

  • ebac33c1422eRevision changes
    • breaking

      request body became required