---
title: database_import
url: "/docs/ai-agents/mcp-tools/databases/database_import/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/databases/database_import/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/databases/database_import.md
summary: Import a database dump into a new database of a database instance, from an
  upload or a backup.
categories:
- mcp
- reference
---

# database_import

Import a database dump into a new database of a database instance, from an upload or a backup. Uploading a dump file happens with the CLI or in Blossom. Returns the Activity; follow it with activity_wait.

| | |
|---|---|
| Access | Changes Blossom |
| Same as | [`blossom database:import`](/docs/reference/cli/database/import/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `upload` | string | Database upload id; alternative to backup. |
| `backup` | string | Backup id; alternative to upload. |
| `database_instance` | string | Instance id; sets data.database_instance_id. |
| `data` | object | Where to import into. Required. |
| `data.database_instance_id` | string | Instance id. |
| `data.name` | string | New database name. |
| `data.timeout_seconds` | integer | Longest import. |

## Example

```json
{"data":{"clone_url":"https://github.com/acme/shop","services":[{"name":"web","command":"web","port":3000,"publicly_exposed":true}]}}
```