DeliveryError

Part of Exceptions in the Python API reference.

Related guidance: reference/exceptions, how-to/troubleshooting.

Runnable examples: preflight.py.

from picogrid_ecn_client import DeliveryError

Report a definite or uncertain mutation delivery phase without implying retry safety.

class DeliveryError(ECNClientError): ...

Source · exceptions.py

Hierarchy: ECNClientError → DeliveryError

`init`

Initialize one secret-safe mutation delivery failure.

def __init__(
    message: object,
    *,
    delivery_phase: DeliveryPhase,
    operation: str,
    task_id: str | None = None,
    operation_id: UUID | None = None,
    code: str | None = None,
    status_code: int | None = None,
    details: Mapping[str, object] | None = None,
    secrets: tuple[str, ...] = (),
) -> None

Parameters

Name	Type	Default	Description
message	object	—	Failure message to redact and expose.
delivery_phase	DeliveryPhase	—	Strongest safe delivery fact established.
operation	str	—	Stable public operation name.
task_id	str \| None	None	Generated task correlation identifier, when applicable.
operation_id	UUID \| None	None	Generated publication operation identifier, when applicable.
code	str \| None	None	Optional stable error-code override.
status_code	int \| None	None	Optional status value associated with the failure.
details	Mapping[str, object] \| None	None	Optional additional secret-safe structured details.
secrets	tuple[str, …]	()	Additional exact values to remove from public text.