Skip to navigation

Batch-import objects into a space

View as Markdown

Bulk-imports up to 200 objects for a definition within a space (used by the extraction-import feed). Authorization: requires space:contribute on :spaceId — lacking it gives 403 (no space:read → 404). Body: { objects: [{ _id?, data, fieldMeta?, provenance?, origin? }] } (1–200 rows). A caller-chosen _id makes the row idempotent — an existing/repeated id is skipped; a non-empty provenance (per-field citation pointers) seeds a pending review per grounded field. A row origin accepts only { actionRunId }; any supplied playbookRunId is ignored because playbook provenance can only be added during playbook execution. Web imports always stay pending: a top-level reviewStatus cannot approve an import. Always returns 200 (never a partial-failure status) with { results, created, skipped, failed }; each result is { index, status: created|skipped|duplicate|invalid, _id?, issues? }.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
definitionIdstringRequired

Request

A top-level reviewStatus is stripped — an import through this API stays pending.

objectslist of objectsRequired

Response

Per-row outcome.

resultslist of objects
createddouble
skippeddouble
faileddouble

Errors

403
Forbidden Error