query_reviews
List and query Perforce reviews with filters for state, keywords, projects, and pagination. Retrieve details, comments, files, activity, and transitions for specific reviews.
Instructions
Get review details and list reviews (READ permission). Open review - state is 'approved but pending=true' or 'needsReview' or 'needsRevision'. Closed review - state is 'approved but pending=false' or 'rejected' or 'archived'.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Review ID to seek to for pagination (list action). Reviews up to and including this ID are excluded. | |
| state | No | Filter by review state(s) (list action). Valid: needsRevision, needsReview, approved, approved:isPending, approved:commit, approved:notPending, rejected, archived | |
| action | Yes | Review query action: list all reviews, dashboard for current user, get specific review, transitions, files_readby, files, comments, activity | |
| fields | No | List of fields to return for list/get actions | |
| keywords | No | Search keyword(s) to filter reviews (list action). Use with keywords_fields. | |
| projects | No | Filter by project name(s) (list action) | |
| review_id | No | Review ID - required for get, transitions, files_readby, files, comments, activity actions | |
| up_voters | No | List of up voters for transitions action | |
| to_version | No | Ending version for files action | |
| max_results | No | Maximum number of results to return | |
| from_version | No | Starting version for files action | |
| result_order | No | Set to 'updated' to return most recently updated reviews first (list action) | |
| after_updated | No | Return reviews updated on the day before this date/time in seconds since epoch (list action). Mutually exclusive with 'after'. | |
| comments_fields | No | Comma-separated list of fields to return for comments action | id,body,user,time |
| keywords_fields | No | Fields to search keywords in (list action). Valid: changes, author, participants, hasReviewer, description, updated, projects, state, testStatus, pending, groups, id | |
| include_transitions | No | Include allowed state transitions in get action response |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||