Get dataset by name

POST

/v1/private/datasets/retrieve

POST

/api/v1/private/datasets/retrieve

curl -X POST http://localhost:5173/api/v1/private/datasets/retrieve \
     -H "Content-Type: application/json" \
     -d '{
  "dataset_name": "string"
}'

200Successful

{
  "name": "string",
  "id": "string",
  "project_id": "string",
  "type": "dataset",
  "visibility": "private",
  "tags": [
    "string"
  ],
  "description": "string",
  "created_at": "2024-01-15T09:30:00Z",
  "created_by": "string",
  "last_updated_at": "2024-01-15T09:30:00Z",
  "last_updated_by": "string",
  "experiment_count": 1,
  "dataset_items_count": 1,
  "optimization_count": 1,
  "most_recent_experiment_at": "2024-01-15T09:30:00Z",
  "last_created_experiment_at": "2024-01-15T09:30:00Z",
  "most_recent_optimization_at": "2024-01-15T09:30:00Z",
  "last_created_optimization_at": "2024-01-15T09:30:00Z",
  "status": "unknown",
  "latest_version": {
    "id": "string",
    "version_hash": "string",
    "version_name": "string",
    "change_description": "string",
    "tags": [
      "string"
    ]
  }
}

Get dataset by name

Request

This endpoint expects an object.

dataset_namestringRequired>=1 character

project_namestringOptional

Response

Dataset resource

namestring>=1 character

idstringOptionalformat: "uuid"

project_idstringOptionalformat: "uuid"

Project ID. Takes precedence over project_name when both are provided.

typeenumOptional

Allowed values:

visibilityenumOptional

Allowed values:

tagslist of stringsOptional

descriptionstringOptionalformat: "(?s)^\s*(\S.*\S|\S)\s*$"0-255 characters

created_atdatetimeOptionalRead-only

created_bystringOptionalRead-only

last_updated_atdatetimeOptionalRead-only

last_updated_bystringOptionalRead-only

experiment_countlongOptionalRead-only

dataset_items_countlongOptionalRead-only

optimization_countlongOptionalRead-only

most_recent_experiment_atdatetimeOptionalRead-only

last_created_experiment_atdatetimeOptionalRead-only

most_recent_optimization_atdatetimeOptionalRead-only

last_created_optimization_atdatetimeOptionalRead-only

statusenumOptionalRead-only

Allowed values:

latest_versionobjectOptionalRead-only

Summary of the latest dataset version