Skip to main content
GET
/
runs
List runs
curl --request GET \
  --url https://api.duvo.ai/v1/runs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "source": "<string>",
      "title": "<string>",
      "run_number": 123,
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_name": "<string>",
      "build_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "case_queue_item_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "case_queue_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "case_queue_name": "<string>",
      "case_title": "<string>",
      "postponed_to": "2023-11-07T05:31:56Z",
      "submitted_prompt_count": 4503599627370495,
      "eval_summaries": {
        "passed": 123,
        "total": 123,
        "final_comment": "<string>",
        "severityCounts": {
          "critical": 4503599627370495,
          "medium": 4503599627370495,
          "low": 4503599627370495
        }
      }
    }
  ],
  "total": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.duvo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Query Parameters

​
limit
number
default:20

Number of runs per page (1-100, default 20)

Required range: 1 <= x <= 100
​
offset
number

Number of runs to skip

Required range: x >= 0
​
sort_by
enum<string>
default:created_at

Field to sort by (default created_at)

Available options:
created_at
​
sort_order
enum<string>
default:desc

Sort direction (default desc)

Available options:
asc,
desc
​
status
enum<string>

Filter to runs with this status

Available options:
not_started,
pending,
starting,
running,
waiting,
completed,
failed,
interrupted,
stopped,
needs_attention
​
agent_id
string<uuid>

Filter to runs for this agent

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
​
user_id
string<uuid>

Filter to runs owned by this user; non-superadmin callers are scoped to themselves regardless of this value

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
​
case_queue_id
string<uuid>

Filter to runs associated with this case queue

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
​
source
string

Filter to runs created from this source (e.g. api, schedule)

​
search
string

Full-text search across run titles and case titles

​
has_issues
enum<string>

If true, only return runs that have evaluation issues

Available options:
true,
false
​
issue_severity
enum<string>

If set, only return runs whose latest successful evaluation has at least one failing rubric with this severity (critical | medium | low). Implies has_issues; legacy evaluations without severity companion fields do not match this filter.

Available options:
critical,
medium,
low
​
since
string<date-time>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
​
digest_id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Response

Default Response

​
data
object[]
required
​
total
number
required