Sign in

v47

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2024-10-01163166522.3 KB
Experiments

Create experiment

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 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.

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

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.

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