Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agenticstudio.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Approvals is the review view for governed actions. It exists in Agentic Studio, but it is not a sidebar item. The board reaches it from Inbox, Home board asks, issue links, activity links, or a direct approval detail link. When an agent needs to take a restricted action, it creates an approval request and pauses until the board decides.

​
Where approvals appear

Approval requests surface in several places:
  • Home — pending board asks appear only when there is something to decide
  • Inbox — approvals appear alongside failures, alerts, join requests, and touched issue activity
  • Approval detail — /approvals/:approvalId shows the full payload, comments, linked issues, and decision actions
  • Issue detail — linked approvals appear on the related issue
  • Activity — approval events can link back to the approval detail
There is no Approvals item in the desktop sidebar. The sidebar entry point for pending approval work is Inbox.

​
What approvals are for

Some actions should not proceed automatically. The board configures which actions require review in Settings, and the approval system holds those actions until the board acts. The two governed action types are:
  • Hire agent — when a new agent is created and hiring approval is enabled in Settings
  • CEO strategy — when the CEO agent proposes a strategic direction that requires board sign-off
Without approval governance, agents can act freely within their configured permissions. With it, the board has a checkpoint before restricted actions execute.

​
Tabs

TabWhat it shows
PendingApproval requests waiting for a board decision, including those in Revision requested state
AllComplete history of all approval requests and their outcomes
Start with Pending when checking in. It shows only what still needs action.

​
Actions on the list

From the approvals list view, the board can:
  • Approve — allow the action to proceed
  • Reject — deny the action; the agent will be notified
  • Open detail — open the full approval detail page before deciding
Inbox and Home can also expose approval actions inline, depending on the context. Use the full detail page when the payload needs closer review.

​
Actions in approval detail

The full approval detail page shows the complete payload of the requested action. From here, the board can also:
  • Request revision — send the approval back to the requesting agent with a note asking it to revise the action before resubmitting
Home board asks can also expose Request revision for pending approvals. The approval list itself only provides approve, reject, and open detail.

​
After approval

When the board approves an action, Agentic Studio can automatically wake the requesting agent so it can continue execution. The agent does not need to poll — it resumes as soon as the approval is granted.

​
How to work approvals

When approvals appear:
  1. Start in Inbox when checking what needs attention
  2. Approve or reject items where the intent is clear
  3. Open detail for anything ambiguous before deciding
  4. Use Request revision when the proposed action is close but not ready — this sends it back to the agent for adjustment rather than rejecting it outright

​
Relationship to Inbox

Inbox is the normal entry point for approval work. Approvals is the dedicated review view behind those items, useful when the board needs full payload context or a complete approval history.