TaskResult

Part of Tasks in the Python API reference.

Related guidance: concepts/tasks, how-to/receive-local-tasks, how-to/dispatch-local-tasks, quickstarts/effector-handler.

Runnable examples: receive_task.py, dispatch_task.py, receive_mesh_task.py, dispatch_mesh_task.py.

from picogrid_ecn_client import TaskResult

Carry a typed or JSON-object task result and its reported status.

TaskResult(
    *,
    task_id: str,
    status: TaskStatus,
    data: ResultT | dict[str, JsonValue] | None = None,
    error_message: str | None = None,
    completed_at: datetime,
)

Source · models/task.py

Fields

Name	Type	Required	Default	Constraints	Description
task_id	str	yes	—	min_length=1, max_length=128	Task correlation identifier, from 1 through 128 characters.
status	TaskStatus	yes	—	—	Reported task result state.
data	ResultT | dict[str, JsonValue] | None	no	None	—	Optional typed result model or JSON object returned by the task.
error_message	str | None	no	None	min_length=1, max_length=1024	Optional flat error detail, from 1 through 1024 characters. Values are stripped of surrounding whitespace before validation, so a blank string is rejected.
completed_at	datetime	yes	—	—	Timezone-aware UTC time when the result was received locally.