Review

Apply a review action to many records

Approve or reject many validation records in one call. Failed ids (not found or not owned by the customer) are reported in the results array rather than aborting the whole batch.

App keys. An app service key reaches this route and every id is checked individually: a record whose Spec the app does not hold at act is reported as { "status": "error", "error": "insufficient_grant" } and is never mutated. act is a distinct grant from read, so an app that can list a record still cannot decide it without one.

post/v1/review/batch

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/review/batch
  • Auth: HTTP bearer

Request body

idsstring[] required

Non-empty list of validation-record UUIDs.

action'approve' | 'reject' required

Decision applied to every record in ids.

Example request

{
  "ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ]
}

Response

Per-record outcomes.

processedinteger required

Number of records successfully updated.

failedinteger required

Number of records that could not be updated (not found, not owned).

Example response

{
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "completed"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.