> For the complete documentation index, see [llms.txt](https://docs.helmut.de/helmut4-releases/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helmut.de/helmut4-releases/v4.13.0/helmut4-components/streamdesigner/nodes/actions/third-party/vidispine/vidicore/vidicore-add-external-id-to-item-action.md).

# VidiCore Add External ID To Item Action

This node adds an **external ID** to an existing **VidiCore item**.

The external ID is used by VidiCore to reference the item from an external system. In a Helmut workflow, this should usually be the **Helmut asset ID**, for example `{job.assetId}`.

Version 2 additionally supports a configurable *external ID prefix*. This can be used to distinguish Helmut asset IDs originating from different Helmut environments, sites, or installations.

When executed successfully, the node result contains the VidiCore item ID.

<figure><img src="/files/TR5dPsWCGt6QGwN1UCnT" alt="" width="349"><figcaption><p>VidiCore Add External ID To Item Action</p></figcaption></figure>

***

#### Configurable Settings

**Async**

Enables or disables asynchronous execution.

**URL**

The URL of the VidiCore system.

Example:

```
https://myVidiCore.com
```

**Item ID**

The ID of the VidiCore item to which the external ID should be added.

Example:

```
VX-1
```

**External ID Prefix**

An optional prefix added to the external ID.

When this field is empty, the prefix defaults to:

```
HELMUT
```

Use a custom prefix when multiple Helmut installations or environments use the same VidiCore system. This helps avoid ambiguity and makes it easier to identify the source environment of an external ID.

Examples:

```
HELMUT_London
HELMUT_Koeln
```

**External ID**

The external ID that should be added to the VidiCore item.

This should usually be the Helmut asset ID.

Example:

```
{job.assetId}
```

***

#### Node Result

The node result contains the VidiCore item ID.

Example:

```
{node.result.?}
```

Typical usage:

```
Item ID: VX-1
External ID Prefix: HELMUT_London
External ID: {job.assetId}
```
