Create an Agent Picks self-run upload
curl --request POST \
--url https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"bundleVersion": 1,
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runner": {
"name": "@devtune/agentpicks",
"version": "<string>"
},
"agent": {
"kind": "<string>",
"version": "<string>",
"model": "<string>"
},
"host": {
"os": "<string>",
"arch": "<string>"
},
"sandbox": {
"provider": "docker",
"imageDigest": "<string>",
"egressIp": "<string>"
},
"request": {
"category": "<string>",
"prompt": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"finishedAt": "2023-11-07T05:31:56Z",
"artifacts": [
{
"name": "<string>",
"bytes": 1,
"sha256": "<string>"
}
]
}
'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads"
payload = {
"bundleVersion": 1,
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runner": {
"name": "@devtune/agentpicks",
"version": "<string>"
},
"agent": {
"kind": "<string>",
"version": "<string>",
"model": "<string>"
},
"host": {
"os": "<string>",
"arch": "<string>"
},
"sandbox": {
"provider": "docker",
"imageDigest": "<string>",
"egressIp": "<string>"
},
"request": {
"category": "<string>",
"prompt": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"finishedAt": "2023-11-07T05:31:56Z",
"artifacts": [
{
"name": "<string>",
"bytes": 1,
"sha256": "<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({
bundleVersion: 1,
runId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runner: {name: '@devtune/agentpicks', version: '<string>'},
agent: {kind: '<string>', version: '<string>', model: '<string>'},
host: {os: '<string>', arch: '<string>'},
sandbox: {provider: 'docker', imageDigest: '<string>', egressIp: '<string>'},
request: {category: '<string>', prompt: '<string>'},
startedAt: '2023-11-07T05:31:56Z',
finishedAt: '2023-11-07T05:31:56Z',
artifacts: [{name: '<string>', bytes: 1, sha256: '<string>'}]
})
};
fetch('https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads', 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/uploads",
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([
'bundleVersion' => 1,
'runId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'runner' => [
'name' => '@devtune/agentpicks',
'version' => '<string>'
],
'agent' => [
'kind' => '<string>',
'version' => '<string>',
'model' => '<string>'
],
'host' => [
'os' => '<string>',
'arch' => '<string>'
],
'sandbox' => [
'provider' => 'docker',
'imageDigest' => '<string>',
'egressIp' => '<string>'
],
'request' => [
'category' => '<string>',
'prompt' => '<string>'
],
'startedAt' => '2023-11-07T05:31:56Z',
'finishedAt' => '2023-11-07T05:31:56Z',
'artifacts' => [
[
'name' => '<string>',
'bytes' => 1,
'sha256' => '<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/uploads"
payload := strings.NewReader("{\n \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\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/uploads")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads")
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 \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "open",
"expires_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"run": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"test_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"analysis": "pending",
"analysis_error": "<string>"
},
"uploads": [
{
"name": "<string>",
"bytes": 123,
"path": "<string>",
"url": "<string>"
}
]
},
"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": {}
}Agent Picks
Create an Agent Picks self-run upload
Open an upload for a bundle the agentpicks CLI wrote on the customer’s own machine. The body is the bundle’s manifest.json, which declares each artifact’s name, bytes and sha256. The response gives one signed Storage address per declared artifact: PUT the artifact’s bytes to its url within two hours, then complete the upload. A url can’t replace an artifact already stored: Storage refuses the PUT, and a retry returns a null url for each artifact already stored, so it PUTs only the rest. The upload expires 24 hours after it is created unless completed. A retry with the same runId returns the same paths with fresh addresses and restarts the 24 hours; a retry for a completed upload returns it with no addresses. Refusals carry a reason: 400 invalid_manifest (the bundle format rejects it), repository_remote_missing (a repository run whose repository has no remote URL; add an origin remote and run it again), duplicate_artifact, artifact_too_large (diff.patch over 800,000 bytes, source-files.json over 1,048,576, any other artifact over 50 MiB; details name the artifact, its bytes and the limit), unknown_category, unknown_request or unknown_stack; 403 plan_excludes_uploads (the account’s Agent Picks plan is not Local Runner, Cloud or Enterprise), project_uploads_off (on Local Runner, uploads are off for this project; a member who manages billing and is on the project turns them on in the project’s Agent Picks settings), analysis_cap_reached (the project has recorded as many self-runs this UTC calendar month as its plan analyses: 500 on Local Runner, no cap on Cloud or Enterprise; deleting a run doesn’t give one back; details name the limit and resets_at, the start of the next UTC month), forbidden or paused; 409 run_exists (another project or a hosted test uses this run id), upload_expired (the upload expired and its artifacts are still being removed; create it again once a cleanup sweep, which runs every 15 minutes, has removed its artifacts, no sooner than 2 hours 15 minutes after it was last created or retried) or upload_deleted (the upload was deleted and its artifacts are still being removed; create it again once a cleanup sweep, which runs every 15 minutes, has removed its artifacts, no sooner than 2 hours 15 minutes after it was last created or retried). The member who created the API key needs project management permission and edit rights on the project; otherwise 403. Not available over MCP: devtune_get_agent_picks_upload reads an upload’s status. Requires Agent Picks. 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.
POST
/
projects
/
{projectId}
/
agent-picks
/
uploads
Create an Agent Picks self-run upload
curl --request POST \
--url https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"bundleVersion": 1,
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runner": {
"name": "@devtune/agentpicks",
"version": "<string>"
},
"agent": {
"kind": "<string>",
"version": "<string>",
"model": "<string>"
},
"host": {
"os": "<string>",
"arch": "<string>"
},
"sandbox": {
"provider": "docker",
"imageDigest": "<string>",
"egressIp": "<string>"
},
"request": {
"category": "<string>",
"prompt": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"finishedAt": "2023-11-07T05:31:56Z",
"artifacts": [
{
"name": "<string>",
"bytes": 1,
"sha256": "<string>"
}
]
}
'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads"
payload = {
"bundleVersion": 1,
"runId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"runner": {
"name": "@devtune/agentpicks",
"version": "<string>"
},
"agent": {
"kind": "<string>",
"version": "<string>",
"model": "<string>"
},
"host": {
"os": "<string>",
"arch": "<string>"
},
"sandbox": {
"provider": "docker",
"imageDigest": "<string>",
"egressIp": "<string>"
},
"request": {
"category": "<string>",
"prompt": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"finishedAt": "2023-11-07T05:31:56Z",
"artifacts": [
{
"name": "<string>",
"bytes": 1,
"sha256": "<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({
bundleVersion: 1,
runId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
runner: {name: '@devtune/agentpicks', version: '<string>'},
agent: {kind: '<string>', version: '<string>', model: '<string>'},
host: {os: '<string>', arch: '<string>'},
sandbox: {provider: 'docker', imageDigest: '<string>', egressIp: '<string>'},
request: {category: '<string>', prompt: '<string>'},
startedAt: '2023-11-07T05:31:56Z',
finishedAt: '2023-11-07T05:31:56Z',
artifacts: [{name: '<string>', bytes: 1, sha256: '<string>'}]
})
};
fetch('https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads', 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/uploads",
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([
'bundleVersion' => 1,
'runId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'runner' => [
'name' => '@devtune/agentpicks',
'version' => '<string>'
],
'agent' => [
'kind' => '<string>',
'version' => '<string>',
'model' => '<string>'
],
'host' => [
'os' => '<string>',
'arch' => '<string>'
],
'sandbox' => [
'provider' => 'docker',
'imageDigest' => '<string>',
'egressIp' => '<string>'
],
'request' => [
'category' => '<string>',
'prompt' => '<string>'
],
'startedAt' => '2023-11-07T05:31:56Z',
'finishedAt' => '2023-11-07T05:31:56Z',
'artifacts' => [
[
'name' => '<string>',
'bytes' => 1,
'sha256' => '<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/uploads"
payload := strings.NewReader("{\n \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\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/uploads")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/agent-picks/uploads")
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 \"bundleVersion\": 1,\n \"runId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"runner\": {\n \"name\": \"@devtune/agentpicks\",\n \"version\": \"<string>\"\n },\n \"agent\": {\n \"kind\": \"<string>\",\n \"version\": \"<string>\",\n \"model\": \"<string>\"\n },\n \"host\": {\n \"os\": \"<string>\",\n \"arch\": \"<string>\"\n },\n \"sandbox\": {\n \"provider\": \"docker\",\n \"imageDigest\": \"<string>\",\n \"egressIp\": \"<string>\"\n },\n \"request\": {\n \"category\": \"<string>\",\n \"prompt\": \"<string>\"\n },\n \"startedAt\": \"2023-11-07T05:31:56Z\",\n \"finishedAt\": \"2023-11-07T05:31:56Z\",\n \"artifacts\": [\n {\n \"name\": \"<string>\",\n \"bytes\": 1,\n \"sha256\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "open",
"expires_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"run": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"test_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "<string>",
"analysis": "pending",
"analysis_error": "<string>"
},
"uploads": [
{
"name": "<string>",
"bytes": 123,
"path": "<string>",
"url": "<string>"
}
]
},
"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": {}
}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
application/json
A self-run bundle's manifest.json as the agentpicks CLI writes it. Its context is reported by the customer's machine and not verified. It names stack or repository, never both.
Available options:
1 Generated by the runner; the upload is keyed on it.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes