curl --request POST \
--url https://api.varg.ai/v2/lineage \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file_id": "file_abc123"
}
'{
"file_id": "<string>",
"job_id": "<string>",
"tool": "<string>",
"model": "<string>",
"prompt": "<string>",
"provider": "<string>",
"cost_cents": 123,
"parent_job_id": "<string>",
"root_job_id": "<string>",
"children_count": 123,
"total_cost_cents": 123,
"output_count": 123,
"output_index": 123,
"primary_file_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"file": {
"url": "<string>",
"media_type": "<string>",
"size_bytes": 123,
"width": 123,
"height": 123,
"duration_ms": 123
},
"input": {},
"breakdown": [
{
"job_id": "<string>",
"tool": "<string>",
"model": "<string>",
"status": "<string>",
"cost_cents": 123,
"is_root": true
}
]
}{
"error": {
"code": "model_not_found",
"message": "Unknown model: flux-shnell",
"details": "<unknown>"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key or JWT"
}
}{
"error": {
"code": "model_not_found",
"message": "Unknown model: flux-shnell",
"details": "<unknown>"
}
}Files
Resolve a file to the job that created it
Given a file_id or a varg URL, returns the job that produced the file
together with its recipe (prompt, model, tool, cost) — so an agent can
“create something similar”. Send file_id or url; file_id wins when
both are present.
POST
/
lineage
curl --request POST \
--url https://api.varg.ai/v2/lineage \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file_id": "file_abc123"
}
'{
"file_id": "<string>",
"job_id": "<string>",
"tool": "<string>",
"model": "<string>",
"prompt": "<string>",
"provider": "<string>",
"cost_cents": 123,
"parent_job_id": "<string>",
"root_job_id": "<string>",
"children_count": 123,
"total_cost_cents": 123,
"output_count": 123,
"output_index": 123,
"primary_file_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"file": {
"url": "<string>",
"media_type": "<string>",
"size_bytes": 123,
"width": 123,
"height": 123,
"duration_ms": 123
},
"input": {},
"breakdown": [
{
"job_id": "<string>",
"tool": "<string>",
"model": "<string>",
"status": "<string>",
"cost_cents": 123,
"is_root": true
}
]
}{
"error": {
"code": "model_not_found",
"message": "Unknown model: flux-shnell",
"details": "<unknown>"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key or JWT"
}
}{
"error": {
"code": "model_not_found",
"message": "Unknown model: flux-shnell",
"details": "<unknown>"
}
}Authorizations
varg API key (varg_...). Get one at app.varg.ai
or run bunx vargai login. App sessions may alternatively send a
Supabase JWT.
Response
Lineage
Readable tool key (image, video, ...)
The main human-readable prompt (prompt, text or render code)
This job plus every descendant
1-based position among the job's outputs
Show child attributes
Show child attributes
The job's input with internal keys (options, webhook_url, _*) removed
Present only when the job has children
Show child attributes
Show child attributes
Was this page helpful?