v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB
Datasets

Create a dataset

Creates a new dataset in the specified project.

post/v2/datasets

Request body

display_namestring required

The display name of the dataset

pathstring required

Entity storage path.

With workspace-level API keys, use the format project/folder/subfolder/.... The first element identifies the project, followed by nested folders (auto-created as needed). Example: Default/agents.

With project-level API keys, the project is predetermined by the API key, so the path is relative to that project. Example: agents. For backward compatibility, a leading project name is ignored when it matches the scoped project.

Example request

{
  "path": "Default"
}

Response

Dataset created successfully. Returns the newly created dataset object.

display_namestring required

The display name of the dataset