SIsignificant-gravitas
v2
executions
review
v2
executions
review

Get Pending Reviews for Execution

Changed on

Get all pending reviews for a specific graph execution.

Retrieves all reviews with status "WAITING" for the specified graph execution that belong to the authenticated user. Results are ordered by creation time (oldest first) to preserve review order within the execution.

Args: graph_exec_id: ID of the graph execution to get reviews for user_id: Authenticated user ID from security dependency

Returns: List of pending review objects for the specified execution

Raises: HTTPException: - 404: If the graph execution doesn't exist or isn't owned by this user - 500: If authentication fails or database error occurs

Note: Only returns reviews owned by the authenticated user for security. Reviews with invalid status are excluded with warning logs.

get/api/review/execution/{graph_exec_id}

Request

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

Path parameters

graph_exec_idstring required

Response

List of pending reviews for the execution

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