---
title: "Import configurations from file"
method: POST
path: "/configurations/import"
tags: ["Import & Export"]
---

# Import configurations from file

`POST /configurations/import`

## Request

- Base URL: `` (relative, and it does not resolve against the document’s source URL)
- URL: `/configurations/import`
- Auth: one of:
  - API key in header `sessionKey`
  - API key in header `clientCode`
  - API key in header `hmac-auth`
  - API key in header `jwt`
- TypeScript: <https://skmtc.dev/erply/apis/cafa-api/docs/configurations/import/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `preserveExistingConfigurations` boolean

## Headers

- `timestamp` string

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: File that contains the data for the import (should be .json)

## Response `200`

OK

- ServerImportResult[]
  - `error` string
  - `id` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/erply/apis/cafa-api.md) - [All operations](https://skmtc.dev/erply/apis/cafa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/erply/apis/cafa-api/revisions/dc9468557835?raw)
