Import / Export API

Bring data in from CSV files and take it out again.

Bulk CSV in and out. An import is a conversation, not a request: upload the file (streamed into a staging table, never held in memory), preview it, map its columns onto a target's fields, then commit. Committing queues the work and returns 202 — a large file is minutes of work — and progress arrives as events on the organization's normal stream rather than by polling. The service owns the job lifecycle as its own journal but owns no domain state: every row it applies becomes an ordinary command to the service that owns that entity, so inventory stays the source of truth for quantities and every invariant is enforced exactly where it always was. Rows are marked complete as they land, so a retried job resumes rather than double-applying.

Base URL

https://import.getmanifold.io

Auth

A bearer token on every call. See the quickstart.

OpenAPI

import-export.openapi.json

targets

What can be imported, and the fields each target accepts.

• GET /targets The entities a CSV can be imported into

imports

Upload, preview, map, and run CSV imports.

• GET /imports A page of the organization's import jobs, newest first
• POST /imports Upload a CSV
• GET /imports/{jobId} One import job, including its live progress counters
• POST /imports/rows Submit rows as JSON rather than as a file
• GET /imports/{jobId}/preview The first limit staged rows plus a suggested mapping
• PUT /imports/{jobId}/target Point a staged or mapped job at another import target
• PUT /imports/{jobId}/mapping Set which CSV column feeds which target field
• POST /imports/{jobId}/commit Queue the import
• GET /imports/{jobId}/failures Every row this job rejected

mappings

Reusable column mappings.

• GET /mappings The organization's saved CSV column mappings
• POST /mappings Save a column mapping for reuse on the next file of the same shape
• DELETE /mappings/{mappingId} Forget a saved mapping

exports

Streaming CSV export, and its preview.

• POST /exports Ask for the organization's rows for a target as CSV
• GET /exports/{exportId}/download Stream an export's rows as CSV
• GET /exports/{target}/preview A page of the rows an export with these options would write

events

Import journal replay.

• GET /events The organization's import journal at or after since
• GET /events/head The journal's position at a moment