Skip to content
QuantCDN

List tasks with optional filtering

GET
/api/v3/organizations/{organisation}/ai/tasks

Lists tasks for an organization with optional filtering. Filters can be combined for powerful queries. * * Filter Examples: * - All tasks in a list: ?taskListId=world-1 * - Pending tasks in a list: ?taskListId=world-1&status=pending * - Tasks assigned to an agent: ?assignedAgentId=agent-code-reviewer * - Combined: ?taskListId=world-1&status=in_progress&assignedAgentId=agent-1 * * Ordering: * Tasks are returned in reverse chronological order (most recent first).

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

Query Parameters

taskListId
string

Filter tasks by task list ID. Task lists are implicit groupings - any string can be used.

Example
world-1
status
string
Allowed values: pending in_progress completed failed cancelled

Filter tasks by status

Example
pending
assignedAgentId
string

Filter tasks by assigned agent ID

Example
agent-code-reviewer
limit
integer
default: 50 >= 1 <= 100

Maximum number of tasks to return (default 50, max 100)

Responses

200

Tasks retrieved successfully

object
tasks
Array<object>
object
taskId
string format: uuid 
550e8400-e29b-41d4-a716-446655440000
orgId
string
quant
taskListId
string
nullable 
world-1
title
string
Process document and create summary
description
string
Extract text from PDF, analyze content
status
string
Allowed values: pending in_progress completed failed cancelled 
in_progress
assignedAgentId
string
nullable 
agent-123
progress
number
<= 1 
0.5
createdAt
integer
1735689600000
updatedAt
integer
1735689700000
count
integer
2

500

Failed to list tasks