Skip to main content
GET
List runs

Authorizations

Authorization
string
header
required

API key created in Duckie Settings -> API Access.

Query Parameters

limit
integer
default:50

Maximum number of runs to return. Defaults to 50 and is capped at 100.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from the previous page's pagination.next_cursor value.

created_after
string<date-time>

Return runs created at or after this ISO timestamp.

created_before
string<date-time>

Return runs created before this ISO timestamp.

status
enum<string>[]

Filter by one or more run statuses. Repeat the parameter for OR matching.

Maximum array length: 200
Available options:
completed,
running,
failed,
cancelled,
paused
ticket_id
string[]

Filter by exact source ticket or conversation ID. Repeat the parameter for OR matching.

Maximum array length: 200
Maximum string length: 200
agent_id
string<uuid>[]

Filter by agent UUID. Repeat the parameter for OR matching.

Maximum array length: 200
source
string[]

Filter by exact run source. Repeat the parameter for OR matching.

Maximum array length: 200
Maximum string length: 120
resolution_type
enum<string>[]

Filter by one or more resolution types. Repeat the parameter for OR matching.

Maximum array length: 200
Available options:
deflected,
resolved,
escalated,
pending
duration[eq]
integer

Filter by exact run duration in seconds.

Required range: x >= 0
duration[gt]
integer

Filter for runs longer than this duration in seconds.

Required range: x >= 0
duration[gte]
integer

Filter for runs at least this many seconds long.

Required range: x >= 0
duration[lt]
integer

Filter for runs shorter than this duration in seconds.

Required range: x >= 0
duration[lte]
integer

Filter for runs no longer than this duration in seconds.

Required range: x >= 0
tool_name
string[]

Filter by exact recorded tool name from tool-call steps. Repeat the parameter for OR matching.

Maximum array length: 200
Maximum string length: 200

Search ticket title, ticket ID, and agent name.

Maximum string length: 300
metadata.<key>
string

Filter by metadata key/value. Replace <key> with a metadata key containing only letters, numbers, dots, underscores, dashes, or colons.

Maximum string length: 500

Response

Run summaries.

data
object[]
required
pagination
object
required