List tasks with optional filtering

GET

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

const url = 'https://dashboard.quantcdn.io/api/v3/organizations/example/ai/tasks?taskListId=world-1&status=pending&assignedAgentId=agent-code-reviewer&limit=50&dependsOn=550e8400-e29b-41d4-a716-446655440000&includeDetails=false';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://dashboard.quantcdn.io/api/v3/organizations/example/ai/tasks?taskListId=world-1&status=pending&assignedAgentId=agent-code-reviewer&limit=50&dependsOn=550e8400-e29b-41d4-a716-446655440000&includeDetails=false' \
  --header 'Authorization: Bearer <token>'

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}

application/json

object

tasks

Array<object>

object

taskId

string format: uuid

orgId

string

taskListId

string

nullable

title

string

description

string

status

string

Allowed values: pending in_progress completed failed cancelled blocked

assignedAgentId

string

nullable

progress

number

<= 1

blockedReason

string

nullable

blockedByTaskIds

Array<string>

nullable

createdAt

integer

updatedAt

integer

taskIds

Task IDs (only with dependsOn filter)

Array<string>

count

integer

dependsOn

The queried task ID (only with dependsOn filter)

string format: uuid

Example

{
  "tasks": [
    {
      "taskId": "550e8400-e29b-41d4-a716-446655440000",
      "orgId": "quant",
      "taskListId": "world-1",
      "title": "Process document and create summary",
      "description": "Extract text from PDF, analyze content",
      "status": "pending",
      "assignedAgentId": "agent-123",
      "progress": 0.5,
      "createdAt": 1735689600000,
      "updatedAt": 1735689700000
    }
  ],
  "count": 2
}

500

Failed to list tasks