# Cosmo Change Asset Action

The **Cosmo Change Asset Action** node updates the storage path of an existing asset in Cosmo.

It is typically used when media files are physically moved on storage (for example during archive or housekeeper workflows). The node informs Cosmo about the new file location and updates the asset reference across all projects that use this media.

If synchronization is enabled, the updated media location will automatically be reflected in Premiere Pro or After Effects after the project is opened.

#### Input Parameters

**Old Path**\
Previous file path of the asset, including filename and extension.

**New Path**\
New storage location of the asset, including filename and extension.

#### Synchronization Options

**Auto Sync**\
If enabled, the updated file location is synchronized automatically when the project is opened.\
If disabled, the project will show a pending synchronization state in the panel and must be synced manually.

**Skip Metadata Sync**\
If enabled, metadata synchronization in the panel is skipped.

**Skip Markers Sync**\
If enabled, marker synchronization in the panel is skipped.

When Auto Sync is disabled, the panel displays an orange counter indicating how many assets still require synchronization or updating.

#### Behavior

* Updates the asset path globally in Cosmo
* Affects all projects referencing the asset
* Does not move the file on storage — it only updates the database reference
* Can be used in archive, migration, or storage relocation workflows
* Supports asynchronous execution

<figure><img src="/files/eKkfKY2HOVlwNLV2vmdH" alt="" width="351"><figcaption><p>Cosmo Change Asset Action</p></figcaption></figure>

#### Typical Use Case

1. A housekeeper or archive workflow moves a media file to long-term storage.
2. The file path changes on disk.
3. This node updates the asset path inside Cosmo.
4. When editors open the project, the media relinks automatically after synchronization.

{% hint style="info" %}
Use [Cosmo Change Asset Action](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/cosmo-16/cosmo-change-asset-action.md) when *all projects* must see the new file location.\
Use [Cosmo Change Project Asset Action](/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/cosmo-16/cosmo-change-project-asset-action.md) when *only one project* should see the new location.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helmut.de/helmut4-releases/helmut4-components/streamdesigner/nodes/actions/cosmo-16/cosmo-change-asset-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
