List tasks with optional filtering

GET

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

• QuantCDN Public Cloud
• QuantGov Cloud

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 * * Reverse Dependency Lookup: * Use dependsOn to find tasks that depend on a specific task (waiting for it to complete): * - ?dependsOn=task-123 - Returns task IDs only (lightweight) * - ?dependsOn=task-123&includeDetails=true - Returns full task objects * - ?dependsOn=task-123&status=pending - Pending tasks waiting for task-123 * * Ordering: * Tasks are returned in reverse chronological order (most recent first).

Authorizations

• BearerAuth

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 blocked

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)

dependsOn

string format: uuid

Reverse lookup: find tasks that depend on this task ID. Returns tasks waiting for the specified task to complete.

Example

550e8400-e29b-41d4-a716-446655440000

includeDetails

boolean

When using dependsOn, return full task objects in addition to IDs. Default false (IDs only for lightweight responses).

Responses

200

Tasks retrieved successfully. Response format varies: standard returns {tasks, count}, with dependsOn returns {taskIds, count, dependsOn}, with dependsOn+includeDetails returns {taskIds, tasks, count, dependsOn}

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 blocked

in_progress

assignedAgentId

string

nullable

agent-123

progress

number

<= 1

0.5

blockedReason

string

nullable

blockedByTaskIds

Array<string>

nullable

createdAt

integer

1735689600000

updatedAt

integer

1735689700000

taskIds

Task IDs (only with dependsOn filter)

Array<string>

count

integer

2

dependsOn

The queried task ID (only with dependsOn filter)

string format: uuid

500

Failed to list tasks