curl --request POST \
--url https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"branch": "<string>"
}
'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs"
payload = { "branch": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: '<string>'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: '<string>'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"projectId": "<string>",
"branchName": "<string>",
"testId": "<string>",
"status": "queued",
"createdAt": "2023-11-07T05:31:56Z",
"codeObjectId": "<string>",
"evaluationRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"observation": 123,
"unit": "<string>",
"verdict": {
"name": "<string>",
"score": 123,
"criteriaTarget": "<string>"
},
"evidence": {},
"failure": {
"code": "EVALUATION_SCOPE_MISSING",
"message": "<string>",
"infrastructure": true,
"details": {}
},
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Start an authored Test asynchronously
Validates a runnable leaf Test and starts its Results Value expression.
When that expression calls a Code object, the Code runs with the ordinary
purpose=automation execution grant it would have received from any
other caller. The route returns after scheduling; poll the run resource
for evidence, observation, native verdict, or infrastructure failure.
curl --request POST \
--url https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"branch": "<string>"
}
'import requests
url = "https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs"
payload = { "branch": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: '<string>'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({branch: '<string>'})
};
fetch('https://davinci-app.com/api/v2/projects/{projectId}/tests/{testId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"projectId": "<string>",
"branchName": "<string>",
"testId": "<string>",
"status": "queued",
"createdAt": "2023-11-07T05:31:56Z",
"codeObjectId": "<string>",
"evaluationRunId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"observation": 123,
"unit": "<string>",
"verdict": {
"name": "<string>",
"score": 123,
"criteriaTarget": "<string>"
},
"evidence": {},
"failure": {
"code": "EVALUATION_SCOPE_MISSING",
"message": "<string>",
"infrastructure": true,
"details": {}
},
"startedAt": "2023-11-07T05:31:56Z",
"completedAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"success": false,
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
Personal access token. The scopes granted at issuance determine both which
operations the key may call and the ceiling on the resource permissions it
can exercise. Each scope family is a ladder: projects:manage implies
projects:write and projects:read; cards:manage implies cards:write
and cards:read; and teams:manage implies teams:write and teams:read.
These are named API capability bundles, not blanket domain roles:
manage exposes only the permissions enumerated for that scope and never
bypasses the acting user's current role-based access.
Path Parameters
Project id. May be compound in the form {projectId}--{branchName}.
1Id of the authored Test object in the source project.
1Body
Branch containing the authored Test. Defaults to main.
255Response
Test run accepted.
completed, failed, cancelled, and timed_out are terminal.
failed means the Code execution or evaluation infrastructure failed;
a valid low observation still completes and may resolve to a failing
Test verdict.
queued, starting, running, evaluating, cancelling, completed, failed, cancelled, timed_out Finite numeric observation committed to the Test's Results Value.
Fixture-defined structured evidence. SYSTEM quality fixtures include transcript, final-tree, usage, and rubric summaries; callers must tolerate additional fixture-specific fields.
Hide child attributes
Hide child attributes
EVALUATION_SCOPE_MISSING, EVALUATION_AGENT_FAILED, EVALUATION_TIMEOUT, EVALUATION_EVIDENCE_MISSING, EVALUATION_OBSERVATION_INVALID, EVALUATION_CLEANUP_FAILED, CODE_EXECUTION_FAILED, TEST_CANCELLED, TEST_RUN_FAILED, TEST_RUN_TIMED_OUT True when no quality verdict may be inferred from this failure.