TaskAcknowledgement

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 TaskAcknowledgement

Report whether a task request was accepted.

TaskAcknowledgement(
    *,
    task_id: str,
    accepted: bool,
    message: str | None = None,
    acknowledged_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.
accepted	bool	yes	—	—	Whether the receiver accepted the task request.
message	str | None	no	None	min_length=1, max_length=512	Optional acknowledgment detail, from 1 through 512 characters.
acknowledged_at	datetime	yes	—	—	Timezone-aware UTC time when the acknowledgment was received locally.