---
title: "Import configuration"
method: POST
path: "/api/config-transfer/import"
tags: ["Config Transfer"]
---

# Import configuration

`POST /api/config-transfer/import`

Imports a previously exported configuration file, transactionally wiping and recreating every
in-scope section of the local configuration (scan modes, ip filters, certificates, transformers,
south and north connectors, history queries and users) from it, preserving each entity's original
id. This is a full replace, not a merge, and cannot be undone. The engine's own settings and the
OIAnalytics registration are never touched. Older exports are brought forward with the
settings-upgrade registry before being applied; nothing is written if the file is malformed, too
new for this OIBus version, or fails validation after any upgrades.

On success, OIBus restarts itself so the running engine picks up the newly written configuration
— the wipe+recreate only touches the database, and the in-memory south/north connectors and
history queries the engine is already running would otherwise keep operating against rows that
no longer exist.

## Response `200`

Configuration imported successfully

- ConfigImportResponseDTO
  - `appliedUpgrades` object[], required
    - `entityId` string
    - `version` string, required
    - `scope` string, required
  - `warnings` string[], required

## Changes

- **2026-08-27** `08f74b792a13` — 1 info
  - endpoint added
- **2026-08-26** `327d6a57cf5b` — 1 breaking
  - api path removed without deprecation
- **2026-08-26** `83e4d87d5c26` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/optimistiksas/apis/oibus-api/changes/api/config-transfer/import/post.md)

---

[API](https://skmtc.dev/optimistiksas/apis/oibus-api.md) · [All operations](https://skmtc.dev/optimistiksas/apis/oibus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optimistiksas/oibus-api/revisions/08f74b792a13/schema)