---
title: "Import Workbook"
method: POST
path: "/api/v1/admin/import"
---

# Import Workbook

`POST /api/v1/admin/import`

## Request

- Base URL: `https://trovastorage.it` (the document declares no server; this is the origin it was published from)
- URL: `https://trovastorage.it/api/v1/admin/import`
- Auth: one of:
  - API key in header `X-Access-Token`
  - HTTP bearer

Read a workbook and say what it would do (`dry_run`, the default) or do
it. `override` lets one row through the company-channels rule; it is named
in the audit event.

## Query parameters

- `filename` string, required
- `dry_run` boolean
- `override` string[]

## Response `200`

Successful Response

- ImportRunDetail
  - `id` string, uuid, required
  - `admin_user_id` string, uuid, nullable, required
  - `file_sha256` string, required
  - `template_version` string, nullable, required
  - `dry_run` boolean, required
  - `counts` object, required
  - `created_at` string, date-time, required
  - `report` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trovastorage/apis/stock-your-inventory.md) · [All operations](https://skmtc.dev/trovastorage/apis/stock-your-inventory/llms.txt) · [OpenAPI document](https://skmtc.dev/trovastorage/apis/stock-your-inventory/revisions/c75f591a585c?raw)