on_error

Language reference / on_error

Meaning and placement

task

The schema declares this field at the location below.

Property	Declaration
Requirement	Optional in this object
Schema location	`/$defs/task/properties/on_error`
$ref	”#/$defs/onError”

In the same object: after · agent · exec · extract · for_each · group · infer · invoke · lift · retry · returns · timeout · when · with Schema source (use the pointer above)

In a source template

Excerpt from templates/api-upload-and-create.nika.yaml, source lines 80–89. This is a fragment, not a runnable workflow.

illustration

          - { name: title, value: "Rehearsal item" }   # SLOT: the metadata fields
        mode: jq
        jq: "{ id: .id, url: .url }"   # SLOT: the fields downstream needs
    on_error:
      # Offline rehearsal, NARROWED to the one thing it may forgive: the key is
      # not configured. A `secrets:` entry whose env var is unset fails
      # NIKA-VAR-001 before any byte leaves (measured on 0.118.7 · the run
      # settles « 1 recovered » on that code) — that absence IS the rehearsal
      # switch. Everything else stays loud: a wired key the API rejects is
      # NIKA-BUILTIN-FETCH-001 naming the 401 (measured), a dead endpoint too.

Templates containing this field

Template	Source
`templates/api-upload-and-create.nika.yaml`	Line 83
`templates/chain.nika.yaml`	Line 50
`templates/docker-report.nika.yaml`	Line 56
`templates/etl-state.nika.yaml`	Line 80
`templates/fanout.nika.yaml`	Line 105
`templates/gate-and-act.nika.yaml`	Line 60
`templates/human-gated-ship.nika.yaml`	Line 99
`templates/media-asset-pack.nika.yaml`	Line 79
`templates/website-brief.nika.yaml`	Line 56

These are literal key occurrences in the source files, not an execution or conformance claim. How to instantiate a template.

Contract and implementation

This page projects the named specification revision. Check released engine status and the validation workflow before running a file. An optional field is not evidence that every engine supports every value. Canonical identity: language:word:on_error. Spec revision: c5ebbb7b862b. How documentation stays connected.

YAML

Language fields

CLI & errors

Data catalogs

Workspace

Documentation system

Tool contracts

Meaning and placement

task

In a source template

Templates containing this field

Contract and implementation

​Meaning and placement

​task

​In a source template

​Templates containing this field

​Contract and implementation

Meaning and placement

task

In a source template

Templates containing this field

Contract and implementation