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

# effort

> Contract, placement, related fields and source examples for this Nika YAML field.

[Language reference](/reference/language/overview) / `effort`

## Meaning and placement

### → run → reasoning

The EXACT native effort value the selected route advertises for the selected model (e.g. `high` where the route offers it) · forwarded verbatim as that route's own option, never translated · there is no universal effort scale. Nonempty, no surrounding whitespace (the Unicode White\_Space property, spelled out in the pattern so every validator agrees; inner characters are kept as written), a literal (never a `${{ }}` template). A value the route does not offer refuses before inference; this schema does not judge which values a route offers.

| Property | Declaration |
| - | - |
| Requirement | Required in this object |
| Schema location | `/properties/run/properties/reasoning/properties/effort` |
| type | `"string"` |
| pattern | declaration below |

<details>
  <summary><code>pattern</code> schema declaration (spec source, not a lesson)</summary>

  ```json theme={"system"}
  "^[^\\t-\\r \\u0085\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000](?:[\\s\\S]*[^\\t-\\r \\u0085\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000])?(?![\\s\\S])"
  ```
</details>

[Schema source (use the pointer above)](https://github.com/supernovae-st/nika-spec/blob/f3a952514b51ce884f42839c627bd88887fc941e/schemas/workflow.schema.json)

## Examples

No matching source-template occurrence is recorded in this projection. [Write a workflow](/guides/templates) or consult the schema declaration above.

## Contract and implementation

This page projects the named specification revision. Check [released engine status](/reference/status) and [the validation workflow](/guides/agent-authoring) before running a file. An optional field is not evidence that every engine supports every value.

Canonical identity: `language:word:effort`. Spec revision: [`f3a952514b51`](https://github.com/supernovae-st/nika-spec/tree/f3a952514b51ce884f42839c627bd88887fc941e).

[How documentation stays connected](/reference/knowledge-system).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.