{ "opencollection": "1.0.0", "info": { "name": "QuantCDN AI Agents AI Task Management API", "version": "4.15.8" }, "request": { "auth": { "type": "bearer", "token": "{{bearerToken}}" } }, "items": [ { "info": { "name": "AI Task Management", "type": "folder" }, "items": [ { "info": { "name": "List tasks with optional filtering", "type": "http" }, "http": { "method": "GET", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" }, { "name": "taskListId", "value": "world-1", "type": "query", "description": "Filter tasks by task list ID. Task lists are implicit groupings - any string can be used." }, { "name": "status", "value": "pending", "type": "query", "description": "Filter tasks by status" }, { "name": "assignedAgentId", "value": "agent-code-reviewer", "type": "query", "description": "Filter tasks by assigned agent ID" }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of tasks to return (default 50, max 100)" }, { "name": "dependsOn", "value": "550e8400-e29b-41d4-a716-446655440000", "type": "query", "description": "Reverse lookup: find tasks that depend on this task ID. Returns tasks waiting for the specified task to complete." }, { "name": "includeDetails", "value": "", "type": "query", "description": "When using dependsOn, return full task objects in addition to IDs. Default false (IDs only for lightweight responses)." } ] }, "docs": "Lists tasks for an organization with optional filtering. Filters can be combined for powerful queries.\n *\n * **Filter Examples:**\n * - All tasks in a list: ?taskListId=world-1\n * - Pending tasks in a list: ?taskListId=world-1&status=pending\n * - Tasks assigned to an agent: ?assignedAgentId=agent-code-reviewer\n * - Combined: ?taskListId=world-1&status=in_progress&assignedAgentId=agent-1\n *\n * **Reverse Dependency Lookup:**\n * Use `dependsOn` to find tasks that " }, { "info": { "name": "Create a new task", "type": "http" }, "http": { "method": "POST", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new task for multi-agent coordination and workflow orchestration.\n *\n * **Key Features:**\n * - **Persistent State**: Tasks survive across conversations and sessions\n * - **Agent Assignment**: Pre-assign tasks to specific agents\n * - **Task Lists**: Group related tasks using taskListId (implicit - no need to create lists first)\n * - **Dependencies**: Define task dependencies for workflow orchestration\n * - **Metadata**: Store flexible JSON metadata for task-s" }, { "info": { "name": "Get task details", "type": "http" }, "http": { "method": "GET", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks/:taskId", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" }, { "name": "taskId", "value": "", "type": "path", "description": "The task UUID" } ] }, "docs": "Retrieves detailed information about a specific task including status, progress, dependencies, and results." }, { "info": { "name": "Update a task", "type": "http" }, "http": { "method": "PUT", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks/:taskId", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" }, { "name": "taskId", "value": "550e8400-e29b-41d4-a716-446655440000", "type": "path", "description": "The task UUID" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Updates an existing task. All fields are optional - only provided fields will be updated.\n *\n * **Status Transitions:**\n * - Changing from **pending** to **in_progress** automatically sets startedAt timestamp\n * - Changing to **completed**, **failed**, or **cancelled** automatically sets completedAt timestamp\n * - Changing to **blocked** automatically sets blockedAt timestamp\n * - Changing from **blocked** to **in_progress** or **pending** clears blocked fields\n * - C" }, { "info": { "name": "Delete a task", "type": "http" }, "http": { "method": "DELETE", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks/:taskId", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" }, { "name": "taskId", "value": "", "type": "path", "description": "The task UUID" }, { "name": "cascade", "value": "", "type": "query", "description": "If true, delete task and all dependent tasks recursively" } ] }, "docs": "Permanently deletes a task. This action cannot be undone.\n *\n * **Dependency Protection:**\n * By default, deletion is blocked if other tasks depend on this task (TASK_HAS_DEPENDENTS error).\n * This prevents breaking workflows.\n *\n * **Cascade Delete:**\n * Use `?cascade=true` to delete the task AND all tasks that depend on it recursively.\n * Useful for cleaning up entire dependency chains.\n *\n * **Examples:**\n * - DELETE /tasks/{id} - Deletes task if no" }, { "info": { "name": "Get dependency graph for a task list", "type": "http" }, "http": { "method": "GET", "url": "https://dashboard.quantcdn.io/api/v3/organizations/:organisation/ai/tasks/:taskListId/dependency-graph", "params": [ { "name": "organisation", "value": "", "type": "path", "description": "The organisation ID" }, { "name": "taskListId", "value": "world-1", "type": "path", "description": "The task list ID to get the dependency graph for" } ] }, "docs": "Returns the full dependency graph for all tasks in a task list.\n *\n * **Use Cases:**\n * - Visualize task dependencies in a UI (DAG diagram)\n * - Analyze workflow structure and critical paths\n * - Find starting tasks (roots) and terminal tasks (leaves)\n * - Plan parallel execution by identifying independent task groups\n *\n * **Response Structure:**\n * - `taskCount`: Total number of tasks in the list\n * - `roots`: Task IDs with no dependencies (starting poin" } ] } ], "bundled": true }