List task versions
curl --request GET \
--url https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions', 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://api.valyu.ai/v1/deepresearch/tasks/{id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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://api.valyu.ai/v1/deepresearch/tasks/{id}/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"head": 2,
"versions": [
{
"version": 2,
"kind": "edit",
"target": {
"kind": "report"
},
"created_at": "2026-11-19T14:20:09.000Z",
"edit_id": "ed_01j9x4k2m8n7p3q5r6s8t0v2w4",
"instruction": "Cut the executive summary to 3 bullets and add the Q3 revenue figure with its citation.",
"summary": "Condensed the Executive Summary to 3 bullets and added the Q3 revenue figure with citation [14].",
"stats": {
"replacements": 1,
"chars_changed": 412,
"citations_added": 1
},
"is_head": true,
"pdf_url": "https://api.valyu.ai/v1/deepresearch/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/report.pdf?version=2"
},
{
"version": 1,
"kind": "original",
"target": {
"kind": "report"
},
"created_at": "2026-11-19T14:12:00.000Z",
"edit_id": null,
"instruction": null,
"summary": null,
"stats": null,
"is_head": false,
"pdf_url": "https://api.valyu.ai/v1/deepresearch/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/report.pdf?version=1"
}
]
}List Versions
Reference for listing report versions on a DeepResearch task via GET /v1/deepresearch/tasks//versions.
GET
/
v1
/
deepresearch
/
tasks
/
{id}
/
versions
List task versions
curl --request GET \
--url https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions', 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://api.valyu.ai/v1/deepresearch/tasks/{id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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://api.valyu.ai/v1/deepresearch/tasks/{id}/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.valyu.ai/v1/deepresearch/tasks/{id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deepresearch_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"head": 2,
"versions": [
{
"version": 2,
"kind": "edit",
"target": {
"kind": "report"
},
"created_at": "2026-11-19T14:20:09.000Z",
"edit_id": "ed_01j9x4k2m8n7p3q5r6s8t0v2w4",
"instruction": "Cut the executive summary to 3 bullets and add the Q3 revenue figure with its citation.",
"summary": "Condensed the Executive Summary to 3 bullets and added the Q3 revenue figure with citation [14].",
"stats": {
"replacements": 1,
"chars_changed": 412,
"citations_added": 1
},
"is_head": true,
"pdf_url": "https://api.valyu.ai/v1/deepresearch/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/report.pdf?version=2"
},
{
"version": 1,
"kind": "original",
"target": {
"kind": "report"
},
"created_at": "2026-11-19T14:12:00.000Z",
"edit_id": null,
"instruction": null,
"summary": null,
"stats": null,
"is_head": false,
"pdf_url": "https://api.valyu.ai/v1/deepresearch/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/report.pdf?version=1"
}
]
}List every version of a DeepResearch task, along with the current
head version number. Every applied edit and every restore appends a new version; prior versions are never deleted.
Each version entry reports its kind (original, edit, or restore), target, created_at, edit_id, instruction, summary, stats, is_head, and pdf_url.
To read the full content, sources, PDF, and deliverable files of any specific version, call Get status with ?version=N. Asset and deliverable file routes (GET /v1/deepresearch/tasks/{id}/assets/report.pdf?version=N and deliverable file routes) also accept ?version=N. To roll back to an earlier version, use Restore version. Only the task owner can inspect version history.Authorizations
API key for authentication. Get yours at platform.valyu.ai.
Response
Version history for the task.
Was this page helpful?