---
title: "Import dashboard"
method: POST
path: "/unstable/documents/import"
tags: ["Content migration"]
---

# Import dashboard

`POST /unstable/documents/import`

Import dashboard to Omni instance.

## Request body

- object
  - `baseModelId` string, uuid, required — Target model ID
  - `dashboard` object, required — Dashboard configuration from export
  - `document` object, required — Document metadata from export
  - `workbookModel` object, required — Workbook model from export
  - `exportVersion` '0.1', required — Export format version (must be "0.1")
  - `identifier` string — Custom identifier for the imported dashboard
  - `folderPath` string — Destination folder path
  - `fileUploads` object[] — Spreadsheet file data to restore during import. Include the `fileUploads` array from the export response to restore spreadsheet tiles in the imported dashboard.
    - `fileUploadId` string — Unique identifier for the file upload (from export)
    - `fileName` string — Original file name
    - `contentType` string — MIME type of the file
    - `data` string — Base64-encoded file content

## Response `200`

Dashboard imported successfully

- object
  - `dashboard` object
    - `dashboardId` string, uuid
  - `miniUuidMap` object
  - `workbook` object

## Other responses

- `400` — Bad Request - Invalid parameters or request body
- `403` — Forbidden Possible error messages/causes: - `User-scoped API keys cannot act on behalf of other users` - Operations targeting personal/restricted scope require the user's **Personal content access** setting (`omni_allows_personal_content` system attribute) to be enabled for the user. If not enabled, the API will respond with `403 Forbidden`.

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)