Review approval requests
Find, approve, or deny requests that need reviewer action.
What this does
The Approval Requests page lists pending and historical requests such as ownership changes, document deletion, group deletion, user actions, and agent template submissions. Reviewers inspect details, comment, and approve or deny eligible requests.
Video planned
Review approval requests walkthrough
Recording planned. Show review approval requests end to end and explain why this task helps a user.
To publish this video:
- Upload the recording to YouTube or Microsoft Stream.
- Save a poster frame as
docs/images/video-posters/guide-review-approval-requests.png. - Add the watch URL to
this slotindocs/_data/media.yml.
Why you would use this
Approvals create a checkpoint before sensitive actions execute. Use this page when a request can affect another user, remove shared content, or publish a template. It is not a general task inbox; only approval-backed actions appear here.
Before you start
- You must have reviewer access for the request type.
- Agent template approvals depend on
enable_agent_template_gallery; see Agents settings. - Safety and feedback review roles may be governed from Safety settings.
Steps
- Open Approval Requests.
- Use Search approvals… to find a request.
- Set Pending Only or All Statuses.
- Use All Types to filter by request type.
- Open the request action from Actions.
- Review Request Details, including Request Type, Target, Requested By, Date, and Reason.
- Add a comment and select Approve & Execute or Deny Request.
Screenshot needed
Review approval requests step 7
Capture the review approval requests task at this step in SimpleChat with realistic sample data and redact secrets.
Save as docs/images/guides/review-approval-requests-step-7.png
Drop the file at that path and it replaces this card automatically. No other change needed.
- For templates, use Agent Template Approvals and its status filters.
Verify it worked
The request status changes in the table. Approved executable requests complete the requested action, while denied requests remain recorded with the decision.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| You cannot approve a request | You are not an eligible reviewer | Ask an eligible reviewer or admin to handle it. |
| Completed requests are hidden | The status filter is Pending Only | Change it to All Statuses. |