curl --request POST \
--url https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quote_token": "<string>",
"max_credits": 2,
"setup": "<string>"
}
'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests"
payload = {
"quote_token": "<string>",
"max_credits": 2,
"setup": "<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({quote_token: '<string>', max_credits: 2, setup: '<string>'})
};
fetch('https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests', 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://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests",
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([
'quote_token' => '<string>',
'max_credits' => 2,
'setup' => '<string>'
]),
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://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests"
payload := strings.NewReader("{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"setup": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"category_slug": "<string>"
},
"status": "queued",
"test_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}Start an Agent Picks test
Start a quoted paid test or re-test. Pass quote_token from the quote and max_credits, the most this test may reserve, in whole credits. The start re-quotes and reserves the fresh high estimate; settlement never charges more, and unused credits return when the test ends. A retry with the same quote token returns status existing and reserves nothing more. Refusals carry a reason: 400 quote_token_invalid (malformed, or quoted for another credential, project or purpose), quote_token_expired, quote_token_setup_mismatch (quoted for another setup than the one this start uses; pass the setup it was quoted for), unpriced_model (a saved model has lost its price since the quote; choose models again), and the quote refusals; 402 insufficient_credits with details.shortfall_credits; 403 forbidden, paused (DevTune support has paused the account) or agent_not_in_plan; 409 estimate_changed (the setup or baseline changed since the quote; quote again), over_max_credits, test_in_progress (another test is active), test_finished (this quote already ran to an end), test_exists or project_deleting. Each start shares the agent-run rate limit. The member who created the API key needs project management permission and edit rights on the project; otherwise 403. This endpoint takes an API key, not an OAuth token; over MCP, an OAuth connection acts as its signed-in member. Requires Agent Picks. Not available in MCP code mode. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason. Requires the agent_picks.run scope.
curl --request POST \
--url https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"quote_token": "<string>",
"max_credits": 2,
"setup": "<string>"
}
'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests"
payload = {
"quote_token": "<string>",
"max_credits": 2,
"setup": "<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({quote_token: '<string>', max_credits: 2, setup: '<string>'})
};
fetch('https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests', 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://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests",
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([
'quote_token' => '<string>',
'max_credits' => 2,
'setup' => '<string>'
]),
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://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests"
payload := strings.NewReader("{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", 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.post("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/tests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quote_token\": \"<string>\",\n \"max_credits\": 2,\n \"setup\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"setup": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"category_slug": "<string>"
},
"status": "queued",
"test_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"status": 123,
"reason": "<string>",
"details": {}
}Authorizations
API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.
Path Parameters
The project the credential is bound to. Read it from GET /connection.
Body
The token from the quote. It works once and expires after 15 minutes.
4096The most credits a person approved one test, or one scheduled run, to reserve. A higher fresh estimate is refused with over_max_credits.
x >= 1The Agent Picks setup to use: its id or its category slug. Optional while the project has one setup. With several, omitting it is refused with 400 and reason agent_picks_setup_required, and a setup the project does not have with 404 and reason agent_picks_setup_not_found; both list the project’s setups in details.setups (id, category_slug, category_name). The response echoes the setup used as setup.
1 - 200