Update the status of a review resource by its resource ID or session ID. This endpoint is used to approve, reject, or revoke reviews for session execution requests.
When a user interacts with a session, a review resource is automatically created containing the configured review groups, each initially set to PENDING
status. All groups must be approved before the session can be executed.
The review status updates affect each review group based on the caller’s context. Once all groups are APPROVED
, or if any group becomes REJECTED
or REVOKED
, the overall resource status updates accordingly.
Review groups contain individual review entries that must be completed by authorized users from specific groups. Each entry represents a required approval from a designated reviewer group.
When a review is created, each group entry is populated with the following structure:
{
"id": "aaa257be-5cc9-401d-ae7e-18ae806d366a",
"group": "banking",
"status": "PENDING",
"reviewed_by": null,
"review_date": null
}
After a review is completed, the entry includes the status, review timestamp, and reviewer information:
{
"id": "a546dfba-d917-4c2b-bc38-7852a7932573",
"group": "banking",
"status": "REJECTED",
"reviewed_by": {
"id": "17e4ff1a-104c-482c-be68-3c01bfc7028e",
"name": "John Doe",
"email": "john.doe@domain.tld",
"slack_id": ""
},
"review_date": "2025-05-27T16:40:05.519754143Z"
}
These states are set directly by reviewers:
APPROVED
- The resource has been approved by the reviewerREJECTED
- The resource is rejected and cannot be updated furtherREVOKED
- The resource is revoked and cannot be updated furtherThese states are managed automatically by the gateway:
PENDING
- Initial state when the review is createdPROCESSING
- Session is being executed; review cannot be updatedEXECUTED
- Session completed successfully; review cannot be updatedUNKNOWN
- Session executed but outcome is indeterminatePENDING
or APPROVED
REJECTED
immediately changes the overall resource status and prevents further updatesAPPROVED
reviews can still be changed to REJECTED
or REVOKED
at any time by the resource owner or administratorsREJECTED
or REVOKED
the resource is considered as immutable and it cannot be updated againReviews in PROCESSING
, EXECUTED
, or UNKNOWN
states are immutable and cannot be modified.
Resource identifier of the session
The request body resource
The body is of type object
.
OK
The response is of type object
.