Update dataset item
curl --request PATCH \
--url https://api.sidenet.ai/v1/datasets/{id}/items/{itemId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": {
"threadId": "conversation-42",
"variables": {
"account.tier": "enterprise"
}
},
"metadata": {
"category": "refunds"
},
"toolMocks": [
{
"toolName": "sendEmail",
"args": {
"to": "maya@example.com"
},
"output": {
"sent": true,
"messageId": "msg_01"
}
}
],
"unmockedToolPolicy": "deny"
}
'import requests
url = "https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}"
payload = {
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": {
"threadId": "conversation-42",
"variables": { "account.tier": "enterprise" }
},
"metadata": { "category": "refunds" },
"toolMocks": [
{
"toolName": "sendEmail",
"args": { "to": "maya@example.com" },
"output": {
"sent": True,
"messageId": "msg_01"
}
}
],
"unmockedToolPolicy": "deny"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: 'Can I get a refund on an order I placed yesterday?',
groundTruth: 'Yes — orders can be refunded within 14 days. Ask for the order number.',
requestContext: {threadId: 'conversation-42', variables: {'account.tier': 'enterprise'}},
metadata: {category: 'refunds'},
toolMocks: [
{
toolName: 'sendEmail',
args: {to: 'maya@example.com'},
output: {sent: true, messageId: 'msg_01'}
}
],
unmockedToolPolicy: 'deny'
})
};
fetch('https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}', 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.sidenet.ai/v1/datasets/{id}/items/{itemId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'input' => 'Can I get a refund on an order I placed yesterday?',
'groundTruth' => 'Yes — orders can be refunded within 14 days. Ask for the order number.',
'requestContext' => [
'threadId' => 'conversation-42',
'variables' => [
'account.tier' => 'enterprise'
]
],
'metadata' => [
'category' => 'refunds'
],
'toolMocks' => [
[
'toolName' => 'sendEmail',
'args' => [
'to' => 'maya@example.com'
],
'output' => [
'sent' => true,
'messageId' => 'msg_01'
]
]
],
'unmockedToolPolicy' => 'deny'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sidenet.ai/v1/datasets/{id}/items/{itemId}"
payload := strings.NewReader("{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.patch("https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}"
response = http.request(request)
puts response.read_body{
"item": {
"id": "dsi_2c7e91b4",
"datasetId": "ds_orders_v3",
"version": 3,
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": null,
"metadata": {
"category": "refunds"
},
"toolMocks": null,
"unmockedToolPolicy": null,
"createdAt": "2026-08-04T10:31:48.006Z",
"updatedAt": "2026-08-04T10:31:48.006Z"
}
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}Datasets
Update dataset item
Edits one item. Only the fields sent change; null clears requestContext or metadata. Bumps the dataset version — earlier versions keep the previous content.
PATCH
/
v1
/
datasets
/
{id}
/
items
/
{itemId}
Update dataset item
curl --request PATCH \
--url https://api.sidenet.ai/v1/datasets/{id}/items/{itemId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": {
"threadId": "conversation-42",
"variables": {
"account.tier": "enterprise"
}
},
"metadata": {
"category": "refunds"
},
"toolMocks": [
{
"toolName": "sendEmail",
"args": {
"to": "maya@example.com"
},
"output": {
"sent": true,
"messageId": "msg_01"
}
}
],
"unmockedToolPolicy": "deny"
}
'import requests
url = "https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}"
payload = {
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": {
"threadId": "conversation-42",
"variables": { "account.tier": "enterprise" }
},
"metadata": { "category": "refunds" },
"toolMocks": [
{
"toolName": "sendEmail",
"args": { "to": "maya@example.com" },
"output": {
"sent": True,
"messageId": "msg_01"
}
}
],
"unmockedToolPolicy": "deny"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: 'Can I get a refund on an order I placed yesterday?',
groundTruth: 'Yes — orders can be refunded within 14 days. Ask for the order number.',
requestContext: {threadId: 'conversation-42', variables: {'account.tier': 'enterprise'}},
metadata: {category: 'refunds'},
toolMocks: [
{
toolName: 'sendEmail',
args: {to: 'maya@example.com'},
output: {sent: true, messageId: 'msg_01'}
}
],
unmockedToolPolicy: 'deny'
})
};
fetch('https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}', 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.sidenet.ai/v1/datasets/{id}/items/{itemId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'input' => 'Can I get a refund on an order I placed yesterday?',
'groundTruth' => 'Yes — orders can be refunded within 14 days. Ask for the order number.',
'requestContext' => [
'threadId' => 'conversation-42',
'variables' => [
'account.tier' => 'enterprise'
]
],
'metadata' => [
'category' => 'refunds'
],
'toolMocks' => [
[
'toolName' => 'sendEmail',
'args' => [
'to' => 'maya@example.com'
],
'output' => [
'sent' => true,
'messageId' => 'msg_01'
]
]
],
'unmockedToolPolicy' => 'deny'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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.sidenet.ai/v1/datasets/{id}/items/{itemId}"
payload := strings.NewReader("{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.patch("https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sidenet.ai/v1/datasets/{id}/items/{itemId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"input\": \"Can I get a refund on an order I placed yesterday?\",\n \"groundTruth\": \"Yes — orders can be refunded within 14 days. Ask for the order number.\",\n \"requestContext\": {\n \"threadId\": \"conversation-42\",\n \"variables\": {\n \"account.tier\": \"enterprise\"\n }\n },\n \"metadata\": {\n \"category\": \"refunds\"\n },\n \"toolMocks\": [\n {\n \"toolName\": \"sendEmail\",\n \"args\": {\n \"to\": \"maya@example.com\"\n },\n \"output\": {\n \"sent\": true,\n \"messageId\": \"msg_01\"\n }\n }\n ],\n \"unmockedToolPolicy\": \"deny\"\n}"
response = http.request(request)
puts response.read_body{
"item": {
"id": "dsi_2c7e91b4",
"datasetId": "ds_orders_v3",
"version": 3,
"input": "Can I get a refund on an order I placed yesterday?",
"groundTruth": "Yes — orders can be refunded within 14 days. Ask for the order number.",
"requestContext": null,
"metadata": {
"category": "refunds"
},
"toolMocks": null,
"unmockedToolPolicy": null,
"createdAt": "2026-08-04T10:31:48.006Z",
"updatedAt": "2026-08-04T10:31:48.006Z"
}
}{
"error": "<string>",
"details": "<string>"
}{
"error": "<string>",
"details": "<string>"
}Authorizations
Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.
Path Parameters
Dataset id.
Example:
"ds_orders_v3"
Dataset item id.
Example:
"dsi_2c7e91b4"
Body
application/json
The prompt the agent is given for this item. A string is one user message; an array of { role, content } messages sets up a multi-turn prompt whose last message is the turn the agent answers.
Example:
"Can I get a refund on an order I placed yesterday?"
The expected answer, for scorers that compare against one (answer similarity, faithfulness, …). A string is the usual shape; an object is accepted for structured outputs.
Example:
"Yes — orders can be refunded within 14 days. Ask for the order number."
Per-item run settings. threadId pins the item to a conversation thread (several items sharing one thread form one conversation; run those with maxConcurrency 1). variables fills the {{placeholders}} in the agent's prompt blocks for this item, merged over the run-level variables leaf by leaf. No other keys are accepted.
Show child attributes
Show child attributes
Free-form labels for the item (a category, a source ticket, …). Passed to scorers as additional context.
Example:
{ "category": "refunds" }
Canned tool results for this item. When the agent calls toolName with args, the run serves output instead of executing the tool — so a side-effecting tool never runs during an experiment and the item is deterministic. toolName is the name the agent sees (the one in a result's toolCalls). args are matched by deep equality (key order ignored, array order significant); set matchArgs: "ignore" to match on the name alone, e.g. for a sub-agent whose prompt is free text. Several mocks for the same tool are consumed in call order. A mocked tool called with other arguments, or more often than it has mocks, fails the item (error.code TOOL_MOCK_MISMATCH / TOOL_MOCK_EXHAUSTED). Tools with no mock run live unless unmockedToolPolicy is deny. null removes every mock.
Maximum array length:
50Show child attributes
Show child attributes
Example:
[ { "toolName": "sendEmail", "args": { "to": "maya@example.com" }, "output": { "sent": true, "messageId": "msg_01" } } ]
What the run does with a tool call this item has no mock for: allow runs the real tool, deny fails the item (error.code TOOL_MOCK_NOT_DECLARED) before it runs. Overrides the run-level unmockedToolPolicy of POST /v1/experiments; the default is allow.
Available options:
allow, deny Example:
"deny"
Response
The updated item
Show child attributes
Show child attributes