curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/actions/list \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/actions/list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devtune.ai/api/v2/projects/{projectId}/actions/list', 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}/actions/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://devtune.ai/api/v2/projects/{projectId}/actions/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://devtune.ai/api/v2/projects/{projectId}/actions/list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/actions/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"actions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"channels": [
"<string>"
],
"priority": "<string>",
"status": "suggested",
"blocked": true,
"assignedTo": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerName": "<string>",
"opportunity": {
"family": "prompt_gap",
"estimated": true,
"percentile": 50,
"components": {
"reach": {
"value": 1,
"unit": "searches_per_month",
"estimated": true
},
"gap": {
"value": 0.5,
"unit": "citation_share",
"normalization": "max(0, topCompetitorCitations - primaryCitations) / max(topCompetitorCitations, 1)"
},
"confidence": {
"value": 0.5,
"unit": "ratio",
"volumeConfidencePenalty": 0.5,
"saturation": {
"signalDays": 2,
"eventEvidence": 2,
"runPlatformObservations": 2
}
}
},
"measuredFacts": [
"<string>"
],
"percentileStatus": "insufficient_reach",
"percentilePoolSize": 1,
"percentileScope": "signal_family",
"measurements": {
"asOfDate": "2023-12-25",
"compositionChange": {
"onlyPrior": {
"cellCount": 1,
"citationCount": 1
},
"onlyCurrent": {
"cellCount": 1,
"citationCount": 1
}
},
"currentCitationCount": 1,
"currentExecutions": 1,
"currentProbeDays": 1,
"matchedCohortCoverage": 0.5,
"priorCitationCount": 1,
"priorExecutions": 1,
"priorProbeDays": 1
}
},
"effortScore": 123,
"portfolioCategory": "<string>",
"portfolioRank": 2,
"steeredFromPageUrl": "<string>",
"followUpOf": {
"actionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"shippedAt": "2023-11-07T05:31:56Z"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"expectedImpact": "<string>",
"isCommandCenter": true,
"primaryCtaKind": "<string>",
"targetLabel": "<string>",
"whatChanged": "<string>",
"whyNow": "<string>",
"context": {
"topEvidence": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"summary": "<string>",
"type": "<string>",
"audit": {
"assessedAt": "2023-11-07T05:31:56Z",
"checks": [
{
"label": "<string>",
"detail": "<string>",
"score": 50,
"failing": true
}
],
"sectionAssessment": {
"version": "<string>",
"contentHash": "<string>",
"inputHash": "<string>",
"assessedAt": "2023-11-07T05:31:56Z",
"status": "complete",
"reason": "no_substantive_sections",
"selection": {
"scannedChars": 1,
"sourceChars": 1,
"candidateCount": 1,
"sampled": true,
"truncated": true
},
"sections": [
{
"locator": "<string>",
"heading": "<string>",
"start": 1,
"end": 1,
"source": "<string>",
"truncated": true
}
],
"findings": [
{
"locator": "<string>",
"kind": "subject_clarity",
"excerpt": "<string>",
"explanation": "<string>",
"remedy": "<string>"
}
]
},
"pageUrl": "<string>",
"citationScope": "<string>"
},
"citationLoss": {
"priorCitationCount": 1,
"currentCitationCount": 1,
"cellCount": 1,
"cells": [
{
"promptId": "<string>",
"platform": "<string>",
"priorCitationCount": 1,
"currentCitationCount": 1,
"promptText": "<string>",
"priorExecutions": 123,
"currentExecutions": 123
}
],
"pageLabel": "<string>",
"priorExecutions": 123,
"currentExecutions": 123
},
"googleEligibility": {
"coverageState": "<string>",
"dimensions": {
"canonical": "pass",
"crawlable": "pass",
"indexed": "pass",
"structuredData": "pass"
},
"observedAt": "2023-11-07T05:31:56Z"
}
}
],
"winningPages": [
{
"rank": 2,
"url": "<string>",
"title": "<string>",
"domain": "<string>",
"assetType": "competitor",
"citationCount": 1,
"citedAnswers": 1,
"promptCount": 2,
"averagePosition": 123
}
]
}
}
],
"pagination": {
"page": 123,
"pageSize": 123,
"totalCount": 123,
"totalPages": 123
}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}List actions
Returns the current actions workspace for a project. Recommendations follow persisted portfolioRank ascending, nulls last, with score, creation time and id as internal tiebreaks. Live recommendations expose opportunity percentiles, components and measured facts; percentileScope signal_family compares like signals and eligible families are interleaved. Legacy scalar scores are never exposed.
curl --request GET \
--url https://devtune.ai/api/v2/projects/{projectId}/actions/list \
--header 'Authorization: Bearer <token>'import requests
url = "https://devtune.ai/api/v2/projects/{projectId}/actions/list"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://devtune.ai/api/v2/projects/{projectId}/actions/list', 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}/actions/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://devtune.ai/api/v2/projects/{projectId}/actions/list"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://devtune.ai/api/v2/projects/{projectId}/actions/list")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://devtune.ai/api/v2/projects/{projectId}/actions/list")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"actions": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"description": "<string>",
"channels": [
"<string>"
],
"priority": "<string>",
"status": "suggested",
"blocked": true,
"assignedTo": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ownerName": "<string>",
"opportunity": {
"family": "prompt_gap",
"estimated": true,
"percentile": 50,
"components": {
"reach": {
"value": 1,
"unit": "searches_per_month",
"estimated": true
},
"gap": {
"value": 0.5,
"unit": "citation_share",
"normalization": "max(0, topCompetitorCitations - primaryCitations) / max(topCompetitorCitations, 1)"
},
"confidence": {
"value": 0.5,
"unit": "ratio",
"volumeConfidencePenalty": 0.5,
"saturation": {
"signalDays": 2,
"eventEvidence": 2,
"runPlatformObservations": 2
}
}
},
"measuredFacts": [
"<string>"
],
"percentileStatus": "insufficient_reach",
"percentilePoolSize": 1,
"percentileScope": "signal_family",
"measurements": {
"asOfDate": "2023-12-25",
"compositionChange": {
"onlyPrior": {
"cellCount": 1,
"citationCount": 1
},
"onlyCurrent": {
"cellCount": 1,
"citationCount": 1
}
},
"currentCitationCount": 1,
"currentExecutions": 1,
"currentProbeDays": 1,
"matchedCohortCoverage": 0.5,
"priorCitationCount": 1,
"priorExecutions": 1,
"priorProbeDays": 1
}
},
"effortScore": 123,
"portfolioCategory": "<string>",
"portfolioRank": 2,
"steeredFromPageUrl": "<string>",
"followUpOf": {
"actionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"shippedAt": "2023-11-07T05:31:56Z"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"expectedImpact": "<string>",
"isCommandCenter": true,
"primaryCtaKind": "<string>",
"targetLabel": "<string>",
"whatChanged": "<string>",
"whyNow": "<string>",
"context": {
"topEvidence": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"title": "<string>",
"summary": "<string>",
"type": "<string>",
"audit": {
"assessedAt": "2023-11-07T05:31:56Z",
"checks": [
{
"label": "<string>",
"detail": "<string>",
"score": 50,
"failing": true
}
],
"sectionAssessment": {
"version": "<string>",
"contentHash": "<string>",
"inputHash": "<string>",
"assessedAt": "2023-11-07T05:31:56Z",
"status": "complete",
"reason": "no_substantive_sections",
"selection": {
"scannedChars": 1,
"sourceChars": 1,
"candidateCount": 1,
"sampled": true,
"truncated": true
},
"sections": [
{
"locator": "<string>",
"heading": "<string>",
"start": 1,
"end": 1,
"source": "<string>",
"truncated": true
}
],
"findings": [
{
"locator": "<string>",
"kind": "subject_clarity",
"excerpt": "<string>",
"explanation": "<string>",
"remedy": "<string>"
}
]
},
"pageUrl": "<string>",
"citationScope": "<string>"
},
"citationLoss": {
"priorCitationCount": 1,
"currentCitationCount": 1,
"cellCount": 1,
"cells": [
{
"promptId": "<string>",
"platform": "<string>",
"priorCitationCount": 1,
"currentCitationCount": 1,
"promptText": "<string>",
"priorExecutions": 123,
"currentExecutions": 123
}
],
"pageLabel": "<string>",
"priorExecutions": 123,
"currentExecutions": 123
},
"googleEligibility": {
"coverageState": "<string>",
"dimensions": {
"canonical": "pass",
"crawlable": "pass",
"indexed": "pass",
"structuredData": "pass"
},
"observedAt": "2023-11-07T05:31:56Z"
}
}
],
"winningPages": [
{
"rank": 2,
"url": "<string>",
"title": "<string>",
"domain": "<string>",
"assetType": "competitor",
"citationCount": 1,
"citedAnswers": 1,
"promptCount": 2,
"averagePosition": 123
}
]
}
}
],
"pagination": {
"page": 123,
"pageSize": 123,
"totalCount": 123,
"totalPages": 123
}
},
"meta": {
"timestamp": "2023-11-07T05:31:56Z",
"projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}{
"error": "<string>",
"message": "<string>",
"status": 123
}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
Query Parameters
summary is default. context adds bounded whyNow, opportunity evidence, metrics, top evidence with structured Google eligibility when available, brief readiness, and follow-up links.
summary, context Filter by action status. Without it the list returns every status, suggested actions first in portfolio rank order.
suggested, accepted, live, archived x >= 11 <= x <= 100