Asks and approvals
When an agent needs a person, the request lands in Review (/dashboard/inbox; the old /dashboard/review redirects there). It is the only place anything is approved.
What shows up
| Kind | What a person does |
|---|---|
| Recommendation | Approve, decline or snooze an action an agent proposes (a proposal) |
| Approval | Approve or reject a gated workflow or mission step |
| Ruling | Decide a question with consequences |
| Choice | Pick one of the options an agent laid out |
| Input | Supply information the agent can't get |
| Credential | Connect or supply a credential |
| Merge | Merge a change (Software Factory) |
| Gate | Resolve a hand-off gate that escalated |
| Run | A run that needs attention |
| Exception | Something failed and needs a person |
| Suggested rule | Adopt or reject a rule learned from feedback |
Each row says which agent is asking and why, with the recommended option pre-selected. With ?scope=all the queue spans every workspace you're in, your own items first.
Deciding
- In the app. The decision sheet: Approve · Decline · Snooze · Save for later · Skip (keys
adsjk). An ask with no options offers Approve / Reject / Mark done; Other takes free text. A note on a reject feeds the learning loop. - In chat. Say what you decide; the
decide_asktool acts only on the person's own words. - By reply in Slack or by text. A reply in the thread where the card was raised decides that card. See Your assistant.
- Over the API.
POST /api/v1/asks/{id}/decide, orPOST /api/v1/reviews/decidefor proposals and gated runs. See REST API. - Over MCP.
review_decideandask_decide.
Deciding needs the approve capability. Every decision records who made it and when, and is scored on the alignment ledger against what the agent recommended.
Filing an ask
Agents file with file_ask (and withdraw with withdraw_ask). Integrations file with POST /api/v1/asks. Keep titles under 80 characters and bodies under 400.
Cards in chat
A decision can also appear inline in chat as a card: kinds action, decision, ask, record and link, with states proposed, filed, decided, deferred, expired and unfiled. A card's decision is the same decision as on Review.