Bulk-review an object’s fields

PATCH

/spaces/:spaceId/objects/:definitionId/:objectId/review

PATCH

/spaces/:spaceId/objects/:definitionId/:objectId/review

$ curl -X PATCH https://api.cloudraker.com/spaces/spaceId/objects/definitionId/objectId/review \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "status": "pending"
> }'

1 {
2   "object": {
3     "_id": "obj_9f8b7c6d5e4a3b2c1d0e",
4     "spaceId": "space_12345abcde",
5     "definitionId": "def_67890fghij",
6     "definitionVersion": 1.1,
7     "data": {},
8     "fieldMeta": {},
9     "createdAt": "2024-01-15T09:30:00Z",
10     "updatedAt": "2024-01-15T09:30:00Z",
11     "createdBy": "user_janedoe",
12     "updatedBy": "user_janedoe",
13     "deletedAt": "2024-01-15T09:30:00Z",
14     "provenance": {},
15     "review": {},
16     "origin": {
17       "actionRunId": "action_abc123xyz",
18       "playbookRunId": "playbook_789def456"
19     }
20   }
21 }

Sets a review status across many of an object’s fields at once (the provenance/AI-import approval flow). Authorization: requires space:contribute on :spaceId; there is no more specific review permission. Lacking it gives 403 (no space:read → 404). Body: { status, note?, fieldKeys? } where status is pending|approved|rejected; fieldKeys defaults to the grounded (provenance) fields, else every data field. An approved/rejected field becomes review-locked against edits. Unknown field key → 404, invalid status → 422 invalid_status. Returns the updated { object }.

Sets a review status across many of an object's fields at once (the provenance/AI-import approval flow). Authorization: requires `space:contribute` on `:spaceId`; there is no more specific review permission. Lacking it gives **403** (no `space:read` → 404). Body: `{ status, note?, fieldKeys? }` where `status` is `pending`|`approved`|`rejected`; `fieldKeys` defaults to the grounded (provenance) fields, else every data field. An `approved`/`rejected` field becomes review-locked against edits. Unknown field key → 404, invalid `status` → 422 `invalid_status`. Returns the updated `{ object }`.

Authentication

AuthorizationBearer

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

Path parameters

spaceIdstringRequired

definitionIdstringRequired

objectIdstringRequired

Request

This endpoint expects an object.

statusenumRequired

Allowed values:

notestringOptional

fieldKeyslist of stringsOptional

Defaults to the grounded (provenance) fields, else every data field.

Response

The object with its review state updated.

objectobject

Errors

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error