Skip to content

Get task details

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

Retrieves detailed information about a specific task including status, progress, dependencies, and results.

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

taskId
required
string format: uuid

The task UUID

Responses

200

Task details retrieved successfully

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
createdByAgentId
string
nullable
agent-coordinator
dependsOn
Array<string>
metadata
object
{
"priority": "high"
}
progress
number format: float
<= 1
0.5
progressMessage
string
Extracted text, analyzing content...
result

Task result data when completed

object
error

Error message if status is failed

string
nullable
retryCount
integer
0
maxRetries
integer
3
createdAt

Unix timestamp in milliseconds

integer format: int64
1735689600000
updatedAt

Unix timestamp in milliseconds

integer format: int64
1735689700000
startedAt

When status changed to in_progress

integer format: int64
nullable
completedAt

When task completed/failed/cancelled

integer format: int64
nullable
expiresAt

TTL timestamp for completed tasks

integer format: int64
nullable

404

Task not found

500

Failed to get task