Promote a calibrated AI rubric
A human actor attests a bounded golden set. The API binds that evidence to the exact rubric and current judge configuration, versions it, and records an explicit blocking promotion in the suite revision.
curl --request POST \
--url https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"calibration": {
"examples": [
{
"exampleId": "<string>"
}
],
"goldenSetVersion": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
},
"expectedRevision": 123
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
calibration: {
examples: [{exampleId: '<string>'}],
goldenSetVersion: 'b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c'
},
expectedRevision: 123
})
};
fetch('https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote"
payload = {
"calibration": {
"examples": [{ "exampleId": "<string>" }],
"goldenSetVersion": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
},
"expectedRevision": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"agentId": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"cases": [
{
"channelKind": "web",
"fixtures": [],
"id": "<string>",
"name": "<string>",
"scenario": {
"messages": [
{
"content": "<string>",
"role": "assistant"
}
],
"type": "nextReply"
},
"scorers": [
{
"key": "<string>",
"required": true,
"caseSensitive": true,
"expected": "<string>",
"type": "textEquals"
}
],
"tags": [],
"timeoutSeconds": 90,
"toolMode": "mocked"
}
],
"createdAt": "2026-08-29T14:30:00Z",
"createdBy": "<string>",
"description": "<string>",
"id": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"name": "<string>",
"revision": 123,
"status": "draft",
"updatedAt": "2026-08-29T14:30:00Z",
"updatedBy": "<string>"
}{
"defined": true,
"inferable": true,
"code": "BAD_REQUEST",
"status": 400,
"message": "<string>",
"data": {
"issues": [
{
"code": "custom",
"message": "<string>",
"path": [
"<string>"
]
}
],
"truncated": true
}
}{
"defined": true,
"inferable": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "FORBIDDEN",
"status": 403,
"message": "<string>",
"data": {
"missingPermissions": [
"agents:read"
]
}
}{
"defined": true,
"inferable": true,
"code": "NOT_FOUND",
"status": 404,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "CONFLICT",
"status": 409,
"message": "<string>",
"data": {
"currentRevision": 4503599627370495
}
}{
"code": "PAYLOAD_TOO_LARGE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}{
"code": "UNSUPPORTED_MEDIA_TYPE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}Authorizations
Organization-scoped Auth0 user access token issued to an approved first-party client or exchanged by a trusted OBO resource server.
Path Parameters
Opaque Arbol resource identifier; the endpoint and tenant-scoped lookup determine its resource type.
64^[a-z][a-z0-9]{1,15}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
Opaque Arbol resource identifier; the endpoint and tenant-scoped lookup determine its resource type.
64^[a-z][a-z0-9]{1,15}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
1 - 1001 - 100^[a-z][a-z0-9_.-]*$Body
Response
OK
Revisioned evaluation case suite owned by one Agent and frozen into each run snapshot.
Opaque Arbol resource identifier; the endpoint and tenant-scoped lookup determine its resource type.
64^[a-z][a-z0-9]{1,15}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
50Show child attributes
Show child attributes
ISO 8601 timestamp with an explicit UTC offset.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$"2026-08-29T14:30:00Z"
1 - 2552000Opaque Arbol resource identifier; the endpoint and tenant-scoped lookup determine its resource type.
64^[a-z][a-z0-9]{1,15}_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
1 - 200x <= 9007199254740991draft, active, archived ISO 8601 timestamp with an explicit UTC offset.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$"2026-08-29T14:30:00Z"
1 - 255curl --request POST \
--url https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"calibration": {
"examples": [
{
"exampleId": "<string>"
}
],
"goldenSetVersion": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
},
"expectedRevision": 123
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
calibration: {
examples: [{exampleId: '<string>'}],
goldenSetVersion: 'b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c'
},
expectedRevision: 123
})
};
fetch('https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.getarbol.com/v1/agents/{agentId}/evaluation-suites/{suiteId}/cases/{caseId}/rubrics/{scorerKey}/promote"
payload = {
"calibration": {
"examples": [{ "exampleId": "<string>" }],
"goldenSetVersion": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
},
"expectedRevision": 123
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"agentId": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"cases": [
{
"channelKind": "web",
"fixtures": [],
"id": "<string>",
"name": "<string>",
"scenario": {
"messages": [
{
"content": "<string>",
"role": "assistant"
}
],
"type": "nextReply"
},
"scorers": [
{
"key": "<string>",
"required": true,
"caseSensitive": true,
"expected": "<string>",
"type": "textEquals"
}
],
"tags": [],
"timeoutSeconds": 90,
"toolMode": "mocked"
}
],
"createdAt": "2026-08-29T14:30:00Z",
"createdBy": "<string>",
"description": "<string>",
"id": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
"name": "<string>",
"revision": 123,
"status": "draft",
"updatedAt": "2026-08-29T14:30:00Z",
"updatedBy": "<string>"
}{
"defined": true,
"inferable": true,
"code": "BAD_REQUEST",
"status": 400,
"message": "<string>",
"data": {
"issues": [
{
"code": "custom",
"message": "<string>",
"path": [
"<string>"
]
}
],
"truncated": true
}
}{
"defined": true,
"inferable": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "FORBIDDEN",
"status": 403,
"message": "<string>",
"data": {
"missingPermissions": [
"agents:read"
]
}
}{
"defined": true,
"inferable": true,
"code": "NOT_FOUND",
"status": 404,
"message": "<string>",
"data": "<unknown>"
}{
"defined": true,
"inferable": true,
"code": "CONFLICT",
"status": 409,
"message": "<string>",
"data": {
"currentRevision": 4503599627370495
}
}{
"code": "PAYLOAD_TOO_LARGE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}{
"code": "UNSUPPORTED_MEDIA_TYPE",
"defined": false,
"inferable": false,
"message": "<string>",
"data": "<unknown>"
}