> For the complete documentation index, see [llms.txt](https://docs.ixhello.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixhello.com/ixhc2/technical-specifications/yflow-a-yaml-based-conversational-flow-language/import-export.md).

# Import/Export

In this context, Import / Export refers to:

* Exporting reusable assets (flows, integrations, MCP servers, auth blocks) from one file or module
* Importing those assets into another file or project
* Treating YAML config as modular, composable building blocks

YFlow files can be imported into Customer v2 and exported for external editing or version control.

#### Import Flow

An Import Flow allows one flow to reuse, include, or invoke another flow that is defined elsewhere (often in another file or module).

Import Flow = reuse an entire conversation flow as a building block

Instead of duplicating logic, you:

* Define a flow once
* Import it
* Invoke it where needed

```
    POST /api/flows/import    
    {    
      "yflow": "<yflow content>"    
    }    
```

#### Export Flow

An Export Flow is a flow that is explicitly made available for reuse outside the file or module in which it is defined.

Export Flow = publish a conversation flow as a reusable public capability

Only exported flows can be:

* Imported into other files
* Referenced by other teams
* Used as shared building blocks

```
GET /api/flows/{id}/export?format=yflow    
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ixhello.com/ixhc2/technical-specifications/yflow-a-yaml-based-conversational-flow-language/import-export.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.