---
title: "Import service database backup"
method: POST
path: "/services/{uuid}/databases/{database_uuid}/imports"
tags: ["Service databases"]
---

# Import service database backup

`POST /services/{uuid}/databases/{database_uuid}/imports`

## Path parameters

- `uuid` string, required
- `database_uuid` string, required

## Request body

- union
  - object
    - `source` 'upload', required
    - `upload_id` string, uuid, required
    - `dump_all` boolean
    - `replace_existing` boolean — Drop matching PostgreSQL objects before restoring a single-database archive.
  - object
    - `source` 's3', required
    - `s3_storage_uuid` string, required
    - `path` string, required
    - `dump_all` boolean
    - `replace_existing` boolean — Drop matching PostgreSQL objects before restoring a single-database archive.
  - object
    - `source` 'server', required
    - `path` string, required
    - `dump_all` boolean
    - `replace_existing` boolean — Drop matching PostgreSQL objects before restoring a single-database archive.

## Response `202`

Import queued

## Other responses

- `409` — Another start, restart or import of this database is already in progress.
- `422` — Validation error.

## Changes

- **2026-09-19** `b5f81ea5b5b5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coollabsio/apis/coolify/changes/services/:uuid/databases/:database_uuid/imports/post.md)

---

[API](https://skmtc.dev/coollabsio/apis/coolify.md) · [All operations](https://skmtc.dev/coollabsio/apis/coolify/llms.txt) · [OpenAPI document](https://skmtc.dev/coollabsio/apis/coolify/revisions/f8b16020e5dd?raw)