on_codes
Meaning and placement
retry
Retry ONLY on these canonicalNIKA-<NS>-<NNN> codes · absent, the engine retries anything transient. Codes, never HTTP status numbers · the retry-side mirror of on_error.on_codes.
In the same object: backoff_max_ms · backoff_ms · backoff_strategy · jitter · max_attempts
Schema source (use the pointer above)
onError
Optional catch-side filter (mirror of retry.on_codes · same regex) · the action applies ONLY when the final error code is listed · unlisted codes fall through to the default fail (spec/05-errors.md §Fields).
In the same object: recover · skip
Schema source (use the pointer above)
In a source template
Excerpt fromtemplates/api-upload-and-create.nika.yaml, source lines 92–99. This is a fragment, not a runnable workflow.
illustration
Templates containing this field
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_codes. Spec revision: c5ebbb7b862b.
How documentation stays connected.