Skip to content
QuantCDN

Create a new task

POST
/api/v3/organizations/{organisation}/ai/tasks
curl --request POST \
  --url https://dashboard.quantcdn.io/api/v3/organizations/example/ai/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "Process document and create summary", "description": "Extract text from PDF, analyze content, and generate executive summary", "taskListId": "world-1", "status": "pending", "assignedAgentId": "agent-code-reviewer", "createdByAgentId": "agent-coordinator", "dependsOn": [ "550e8400-e29b-41d4-a716-446655440000" ], "metadata": { "priority": "high", "tags": [ "document-processing" ], "workflow": "document-pipeline" }, "maxRetries": 3, "blockedReason": "Waiting for approval", "blockedByTaskIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }'

Creates a new task for multi-agent coordination and workflow orchestration. * * Key Features: * - Persistent State: Tasks survive across conversations and sessions * - Agent Assignment: Pre-assign tasks to specific agents * - Task Lists: Group related tasks using taskListId (implicit - no need to create lists first) * - Dependencies: Define task dependencies for workflow orchestration * - Metadata: Store flexible JSON metadata for task-specific data * - Progress Tracking: Track progress from 0.0 to 1.0 * * Use Cases: * - Break down complex requests into manageable steps * - Assign work to specialized agents * - Track long-running operations * - Coordinate multi-agent workflows

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
organisation
required
string

The organisation ID

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
title
required

Task title

string
Example
Process document and create summary
description

Detailed task description

string
Example
Extract text from PDF, analyze content, and generate executive summary
taskListId

Task list ID for grouping related tasks (implicit - lists are created automatically)

string
Example
world-1
status

Initial task status

string
default: pending
Allowed values: pending in_progress completed failed cancelled blocked
assignedAgentId

Pre-assign task to specific agent

string
Example
agent-code-reviewer
createdByAgentId

Agent ID that created this task

string
Example
agent-coordinator
dependsOn

Task IDs that must complete before this task can start

Array<string>
Example
[
  "550e8400-e29b-41d4-a716-446655440000"
]
metadata

Flexible JSON metadata for task-specific data

object
Example
{
  "priority": "high",
  "tags": [
    "document-processing"
  ],
  "workflow": "document-pipeline"
}
maxRetries

Maximum retry attempts on failure

integer
default: 3 <= 10
blockedReason

Reason task is blocked (when status is blocked)

string
Example
Waiting for approval
blockedByTaskIds

Task IDs that are blocking this task

Array<string>

Responses

Section titled “Responses”

201

Section titled “201”

Task created successfully

Media typeapplication/json
object
taskId
string format: uuid
orgId
string
title
string
status
string
createdAt
integer
Examplegenerated
{
  "taskId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "orgId": "example",
  "title": "example",
  "status": "example",
  "createdAt": 1
}

400

Section titled “400”

Invalid request

500

Section titled “500”

Failed to create task