Skip to main content
POST
Create Dataset Group
Legacy Dataset, Evaluation, and Report endpoints are deprecated for new workflows. Use the Tables API for new dataset import, evaluation, scoring, recalculation, and reporting workflows.
Create a dataset group in a workspace. PromptLayer also creates an initial draft dataset for the group with version_number = -1.

Behavior Notes

  • Dataset group names must be unique within a workspace.
  • If folder_id is omitted, the dataset group is created at the workspace root.
  • Use Resolve Folder ID by Path to look up a folder ID, or Create Folder to create one.

Authorizations

X-API-KEY
string
header
required

Body

application/json

Dataset group creation payload.

name
string
required

Name for the dataset group. Must be unique within the workspace.

workspace_id
integer | null

Workspace ID. Defaults to the workspace associated with the API key.

folder_id
integer | null

Folder ID to create the dataset group in. Omit to create at the workspace root.

external_ids
ExternalId · object[]

External ID mappings to attach to the dataset group.

Response

Dataset group created.

success
enum<boolean>
required
Available options:
true
dataset_group
DatasetGroup · object
required
dataset
Dataset · object
required

Initial draft dataset created with version_number = -1.

external_ids
ExternalId · object[]
required
message
string