Batch-import objects into a space

POST

/spaces/:spaceId/objects/:definitionId/batch

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? }.

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

$	curl -X POST https://api.cloudraker.com/spaces/spaceId/objects/definitionId/batch \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"objects": [
>	{
>	"data": {}
>	}
>	]
>	}'

1	{
2	"results": [
3	{
4	"index": 0,
5	"status": "created",
6	"_id": "obj-12345",
7	"fieldKey": "name",
8	"issues": [
9	{
10	"fieldKey": "description",
11	"message": "Missing required description field"
12	}
13	]
14	}
15	],
16	"created": 1,
17	"skipped": 0,
18	"failed": 0
19	}