SIsignificant-gravitas
v2
executions
review
v2
executions
review

Get Pending Reviews

Changed on

Get all pending reviews for the current user.

Retrieves all reviews with status "WAITING" that belong to the authenticated user. Results are ordered by creation time (newest first).

Args: user_id: Authenticated user ID from security dependency

Returns: List of pending review objects with status converted to typed literals

Raises: HTTPException: If authentication fails or database error occurs

Note: Reviews with invalid status values are logged as warnings but excluded from results rather than failing the entire request.

get/api/review/pending

Request

  • The document declares no server URL.
  • Auth
    HTTP bearer

Query parameters

pageinteger

Page number (1-indexed)

page_sizeinteger

Number of reviews per page

Response

List of pending reviews

node_exec_idstring required

Node execution ID (primary key)

node_idstring

Node definition ID (for grouping)

user_idstring required

User ID associated with the review

graph_exec_idstring nullable

Graph execution ID; None for a chat review

graph_idstring nullable

Graph ID

graph_versioninteger nullable

Graph version

session_idstring nullable

Chat session ID; None for a graph review

instructionsstring nullable

Instructions or message for the reviewer

editableboolean required

Whether the reviewer can edit the data

status'WAITING' | 'APPROVED' | 'REJECTED' required
review_messagestring nullable

Optional message from the reviewer

expert_idstring nullable

Expert attributed to the requesting run

expert_namestring nullable
expert_avatar_urlstring nullable
agent_namestring nullable

Display name of the agent that requested the review

block_idstring nullable

The block awaiting approval, when a block asked

actionstring nullable

What that block does, e.g. 'Send Discord Message'

library_agent_idstring nullable

For run deep links

was_editedboolean nullable

Whether the data was modified during review

processedboolean

Whether the review result has been processed by the execution engine

created_atstring date-time required

When the review was created

updated_atstring date-time nullable

When the review was last updated

reviewed_atstring date-time nullable

When the review was completed

Changes

  • aa09edb35710Revision changes
    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status

    • breaking

      response property items/graph_exec_id list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property items/graph_id list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property items/graph_version list-of-types was widened by adding types null to media type application/json of response 200

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 19919e303780Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status