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

# url

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

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

## Meaning and placement

### infer → vision · items

The schema declares this field at the location below.

| Property | Declaration |
| - | - |
| Requirement | Optional in this object |
| Schema location | `/$defs/infer/properties/vision/items/properties/url` |
| type | `"string"` |

**In the same object:** [path](https://docs.nika.sh/reference/language/words/path.md) · [source](https://docs.nika.sh/reference/language/words/source.md)

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

## In a source template

Excerpt from `templates/api-upload-and-create.nika`, source lines 69–78. This is a fragment, not a runnable workflow.

```yaml illustration theme={"system"}
    invoke:
      tool: "nika:fetch"
      args:
        url: "${{ const.api_base }}/items"   # SLOT: the create endpoint
        method: POST
        headers:
          x-api-key: "${{ secrets.API_KEY }}"  # SLOT: the auth header name
        multipart:
          # Exactly one of `path:` (file) or `value:` (text) per part — a part
          # carrying both, or neither, is refused before anything is sent.
```

### Templates containing this field

| Template | Source |
| - | - |
| `templates/api-upload-and-create.nika` | [Line 72](https://github.com/supernovae-st/nika-spec/blob/5c40ba456c53a4ab663a949d44003078e161305d/templates/api-upload-and-create.nika#L72) |
| `templates/etl-state.nika` | [Line 106](https://github.com/supernovae-st/nika-spec/blob/5c40ba456c53a4ab663a949d44003078e161305d/templates/etl-state.nika#L106) |
| `templates/gate-and-act.nika` | [Line 55](https://github.com/supernovae-st/nika-spec/blob/5c40ba456c53a4ab663a949d44003078e161305d/templates/gate-and-act.nika#L55) |
| `templates/website-brief.nika` | [Line 51](https://github.com/supernovae-st/nika-spec/blob/5c40ba456c53a4ab663a949d44003078e161305d/templates/website-brief.nika#L51) |

These are literal key occurrences in the source files, not an execution or conformance claim. [How to instantiate a template](https://docs.nika.sh/guides/templates.md).

## 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:url`. 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.