> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ctrlrun.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# AmbiguousEffect

> The outcome of this effect is unknown; only a human may resolve it (SPEC-v0.1 §5.4).

`ctrlrun.AmbiguousEffect` — class, defined at `src/ctrlrun/errors.py:141`

```python theme={null}
class AmbiguousEffect(CTRLRunError)
    def __init__(message: str | None, effect_key: str, action_id: str | None)
```

The outcome of this effect is unknown; only a human may resolve it (SPEC-v0.1 §5.4).

Raised for a record already in `AMBIGUOUS`, and for one whose lease expired mid-flight:
the worker may have died after the remote committed. A retry is refused either way,
until `ctrlrun resolve` says which it was.

## Next

* [Python API index](/reference/api/index).
* [Get started](/get-started/quickstart) · [Why](/why).


## Related topics

- [Errors](/reference/errors.md)
- [Resolve an AMBIGUOUS effect](/guides/resolve-an-ambiguous-effect.md)
- [OpenAI Agents SDK tool approval](/cookbook/openai-agents-tool-approval.md)
- [Three ways in](/get-started/three-ways-in.md)
- [Fail closed](/concepts/fail-closed.md)