Create Dataset Group
curl --request POST \
--url https://api.promptlayer.com/api/public/v2/dataset-groups \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"name": "Customer support eval set",
"folder_id": 17
}
'import requests
url = "https://api.promptlayer.com/api/public/v2/dataset-groups"
payload = {
"name": "Customer support eval set",
"folder_id": 17
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Customer support eval set', folder_id: 17})
};
fetch('https://api.promptlayer.com/api/public/v2/dataset-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.promptlayer.com/api/public/v2/dataset-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Customer support eval set',
'folder_id' => 17
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.promptlayer.com/api/public/v2/dataset-groups"
payload := strings.NewReader("{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.promptlayer.com/api/public/v2/dataset-groups")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.promptlayer.com/api/public/v2/dataset-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Dataset group created successfully",
"dataset_group": {
"id": 123,
"name": "Customer support eval set"
},
"dataset": {
"id": 456,
"version_number": -1
},
"external_ids": []
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"message": "<string>",
"success": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Datasets API
Create Dataset Group
POST
/
api
/
public
/
v2
/
dataset-groups
Create Dataset Group
curl --request POST \
--url https://api.promptlayer.com/api/public/v2/dataset-groups \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"name": "Customer support eval set",
"folder_id": 17
}
'import requests
url = "https://api.promptlayer.com/api/public/v2/dataset-groups"
payload = {
"name": "Customer support eval set",
"folder_id": 17
}
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Customer support eval set', folder_id: 17})
};
fetch('https://api.promptlayer.com/api/public/v2/dataset-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.promptlayer.com/api/public/v2/dataset-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Customer support eval set',
'folder_id' => 17
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.promptlayer.com/api/public/v2/dataset-groups"
payload := strings.NewReader("{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.promptlayer.com/api/public/v2/dataset-groups")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.promptlayer.com/api/public/v2/dataset-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": \"Customer support eval set\",\n \"folder_id\": 17\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Dataset group created successfully",
"dataset_group": {
"id": 123,
"name": "Customer support eval set"
},
"dataset": {
"id": 456,
"version_number": -1
},
"external_ids": []
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"message": "<string>",
"success": false
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}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.
version_number = -1.
Behavior Notes
- Dataset group names must be unique within a workspace.
- If
folder_idis 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.
Related
Authorizations
Body
application/json
Dataset group creation payload.
Name for the dataset group. Must be unique within the workspace.
Workspace ID. Defaults to the workspace associated with the API key.
Folder ID to create the dataset group in. Omit to create at the workspace root.
External ID mappings to attach to the dataset group.
Show child attributes
Show child attributes
Response
Dataset group created.
Available options:
true - DatasetGroup
- Option 2
Show child attributes
Show child attributes
Initial draft dataset created with version_number = -1.
- Dataset
- Option 2
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?

