# Incoming update metadata

With the **Incoming Update Metadata** trigger, the workflow process starts when the metadata of a file transferred to a specific virtual path is modified.

For example, when a partner inserts or updates metadata with the [HTTP MFT Rest API](/data-mover-1.21/api/http-mft-rest-apis.md), the contract starts if it has an action associated with the **Incoming update metadata** workflow on that specific virtual path.

The **Incoming Update Metadata** trigger requires a virtual path.&#x20;

**Execution Variable**

When executed, this trigger adds an execution variable named `file`, of type `FileDetail`. Its attributes are set based on the information sent from the event that initiated the trigger.&#x20;


---

# 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.primeur.com/data-mover-1.21/workflow-templates/triggers/incoming-update-metadata.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.
