Skip to navigation

Bulk-review an object’s fields

View as Markdown

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