# Import Configuration Files into Alumio with API

**URL:** <https://forum.alumio.com/t/import-configuration-files-into-alumio-with-api/202>\
**Category:** Best Practices\
**Tags:** best-practice, alumio-api\
**Created:** [October 10, 2022, 12:53pm UTC](https://forum.alumio.com/t/import-configuration-files-into-alumio-with-api/202 "2022-10-10T12:53:41Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![Alumio\_Bot](https://forum.alumio.com/user_avatar/forum.alumio.com/alumio_bot/32/1824_2.png) [@Alumio\_Bot](https://forum.alumio.com/u/Alumio_Bot)\
**Post date:** [October 10, 2022, 12:53pm UTC](https://forum.alumio.com/t/import-configuration-files-into-alumio-with-api/202/1 "2022-10-10T12:53:42Z")

</div>

### **Table of Contents**

- Introduction
- Export and Import Files to Alumio
- Troubleshooting
- Error message: No route found for …
- Error message: A configuration with this identifier already exists. \n Please enter a unique value for the identifier

### **Purpose**

This article explains how you can synchronize configurations between Alumio environments. You can export the connections files in JSON format from one environment and import them to another Alumio environment.

### **Introduction**

By exporting the Alumio configurations in JSON format, you can move those configurations to other Alumio environments using the Alumio API. For example, moving configurations from the sandbox environment to the production environment.

### **Export and Import Files to Alumio**

To import the file back to Alumio you need to:

1. Export the connection from Alumio.

2. Open the environment you want to import the file to.

3. Go _Settings → Info_, and copy the API URL Ex: “[api.sandbox.demo.alumio.com](http://api.sandbox.demo.alumio.com)”.

4. Next, paste it into Postman: _New request → post →_ paste the link [api.sandbox.demo.alumio.com](http://api.sandbox.demo.alumio.com) followed by the endpoint api/v1/di/configurations, so it looks like [api.sandbox.demo.alumio.com/api/v1/di/configurations](https://api.sandbox.demo.alumio.com/api/v1/di/configurations).

5. Choose _body → raw →_ and in _“text”_ section select JSON → paste the data from the .ndjson file that you exported earlier from Alumio into the _“body”_ field.

6. The next step is to generate API keys in Alumio and use them for authorization in Postman.

Please refer to [this guide](https://forum.alumio.com/t/api-keys-in-alumio/186) to generate API keys.

1. Finally, hit _“Send”_. It should import the file to Alumio.

Note: It is also possible to update existing configurations using a ‘PUT’ request.

[![](https://alumio-forum.s3.dualstack.eu-central-1.amazonaws.com/uploads/original/1X/f563095812aee7a1be85b42d9a2fa5aa42590702.jpeg "How to Import Configuration Files in JSON format to Alumio") ](https://www.youtube.com/watch?v=hKl6KncKs4w)

### **Troubleshooting**

#### **Error message: No route found for …**

```auto
{
"status": 500,
"type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
"title": "Internal Server Error",
"detail": "No route found for \"POST /vi/di/configurations\" (from \"http://api.sandbox.demo.alumio.com/vi/di/configurations\")"
}

```

This indicates that there is something incorrect with the payload. In some cases, the ‘description’ field has a _NULL_ value. However, this API endpoint does not accept this value. Solve this by changing the value from _NULL_ to an empty string (“”).

#### 

**Error message: A configuration with this identifier already exists. \n Please enter a unique value for the identifier**

```auto
{
"status": 500,
"type": "http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
"title": "Internal Server Error",
"detail": "A configuration with this identifier already exists. \n Please enter a unique value for the identifier"
}

```

It obviously means that you have already imported this file and it already exists.

---

<div class="post-metadata">

**Author:** ![o.plokha](https://forum.alumio.com/user_avatar/forum.alumio.com/o.plokha/32/337_2.png) [@o.plokha](https://forum.alumio.com/u/o.plokha)\
**Post date:** [January 21, 2026, 10:14am UTC](https://forum.alumio.com/t/import-configuration-files-into-alumio-with-api/202/2 "2026-01-21T10:14:05Z")

</div>