How do I import and export data?

Requires Basic

Quick answer

Use Import & Export (route /data) to create many assets at once or to pull out your inventory. Import accepts CSV and JSON; there’s a sample CSV template with all supported columns. Export delivers your assets as CSV or JSON — optionally filtered by type and status. Only type (asset_type) and name are required for import.

Prerequisites

Required role Logged-in user (typically an administrator or asset manager)

— Import and export are open to any logged-in user; in practice, they’re tasks for an administrator or asset manager. Programmatically, a valid bearer token is enough.

Import/export are part of the Assets core and included in all plans. Keep in mind your license’s asset limit: a very large import can exceed it.

Overview

GUI (web interface)

1. Open the “Import & Export” section. Select the section for Data (route /data) in the left-hand navigation. Here you’ll find the upload field for import and the buttons for export.

   Screenshot pending import-export-uebersicht-01 Import/export page with file upload and export buttons

   The import/export page with the upload area and export options.

2. Choose a direction. To import, upload a CSV/JSON file; to export, choose the format and download the file. Details are in the linked guides under Related topics.

API (curl)

The endpoints live under the assets prefix /api/v1/assets:

• Import: POST /api/v1/assets/import (file upload, CSV or JSON)
• Template: GET /api/v1/assets/import/template.csv
• Export: GET /api/v1/assets/export?fmt=json|csv

Export the inventory as JSON

curl -H "Authorization: Bearer inv_dein_token" \
  "https://demo.notory.io/api/v1/assets/export?fmt=json" \
  --output assets.json

What happens behind the scenes?

• No dedicated license gate: Import/export are tied to assets and aren’t separately tiered — they work from Basic onward.
• Import always creates new records: Every valid row is saved as a new asset. There’s no automatic duplicate check — importing the same file twice creates duplicates. Details in CSV import.
• Fault-tolerant: Invalid records are skipped, and the rest are imported — the import doesn’t fail completely.
• Your tenant only: Export delivers only assets from your tenant (excluding the recycle bin); import creates assets in your tenant.

Related topics

• Import assets from a CSV file
• Import & export via JSON
• Export your inventory for a backup
• How do I create an asset? — a single asset via the interface
• API introduction