> ## 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.

# save

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

[Language reference](https://docs.nika.sh/reference/language/overview.md) / `save`

## Meaning and placement

### agent → images

Where the engine writes the received bytes: the first image at this path, image n (n >= 2) with `-n` before its extension. Judged against `permits.fs.write` before any byte is written; `${{ }}` allowed. No image received fails NIKA-AGENT-007.

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/$defs/agent/properties/images/properties/save` |
| type | `"string"` |
| minLength | `1` |

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

## Examples

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

## Contract and implementation

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

Canonical identity: `language:word:save`. Spec revision: [`5c40ba456c53`](https://github.com/supernovae-st/nika-spec/tree/5c40ba456c53a4ab663a949d44003078e161305d).

[How documentation stays connected](https://docs.nika.sh/reference/knowledge-system.md).


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