7.2 Status and error reference
A status describes how work is progressing; an error explains why it did not continue. Find the relevant execution record before deciding whether to retry.
Common work states
- Waiting or queued: execution has not started. Check the assigned employee and prerequisites.
- Running: the model or tools are still working. Check the latest activity.
- Needs your attention: something needs more information, a decision, or permission.
- Completed: execution has ended. Check the result against the acceptance criteria.
- Failed or stopped: inspect the cause, any external effects that already occurred, and the available recovery options.
The exact UI labels can differ by object. An automation's enabled state and the state of an individual task run are separate fields.
Recognizable error categories
| Error | Meaning and next step |
|---|---|
teloa/invalid-input | Invalid input format or fields. Check the indicated location and locked versions. |
teloa/forbidden | The operation is not allowed. Check identity, scope, and permissions; do not bypass them. |
teloa/storage-corrupt | Stored data does not match the expected identity or checksum. Preserve evidence, then check the source. |
reference/not-found | The reference is not available. List readable references first. |
reference/version-conflict | The reference version has changed. List it again and verify the new version; do not automatically replace old evidence. |
reference/source-unavailable | The file, encoding, size, or source prevents reading. |
teloa/version-conflict | The task, employee or material version changed; re-read before submitting. |
teloa/conflict | The current state conflicts (for example an in-flight run or a closed task); resolve the original object first. |
teloa/permission-mode-unavailable | The requested permission mode is unavailable; the Employee API exposes permission_mode_unavailable. Adjust the request or configuration and start a new request. |
teloa/model-unavailable | The requested provider/model is unavailable; the Employee API exposes model_unavailable. Do not assume a silent model switch. |
This table covers common categories, not every error code. The current contracts define the complete error objects. Include the redacted message, version, and triggering action in an issue report.