Skip to main content
GET
List task versions
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

X-API-Key
string
header
required

API key for authentication. Get yours at platform.valyu.ai.

Path Parameters

id
string
required

DeepResearch task ID.

Response

Version history for the task.

Version history for a DeepResearch task.

deepresearch_id
string
required

DeepResearch task ID.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

head
integer
required

Current head version number.

Required range: x >= 1
Example:

2

versions
object[]
required

All versions of the task.