Bulk Create Cards

POST 
/api/v1/cards/bulk-create

Batched card creation for the spreadsheet importer.

Each row carries its own row_index so the caller can pair the response back to its spreadsheet row. Parents may be referenced by UUID (parent_id) or by (parent_path, parent_name) — the server resolves names server-side against the existing inventory and against other rows in the same request (which may not exist yet).

Rows are processed in topological order: parents come before children so FK constraints never fire. If a row's parent cannot be resolved even after every other row has been placed, it fails with a clear parent_not_resolved error instead of producing an orphan card.

Single transaction per request — partial failures still roll back succeeded rows in the same batch. Permission: inventory.create.

Request

Responses

200

Successful Response

422

Validation Error