Book a build call
Back to Help
Guide

Answer what waits for you: Approvals

4 min read

Your agent handles routine work on its own. When it wants to do something you asked to be consulted on, it stops and parks that one action in the Approval Queue until you decide. This guide walks that page button by button. For the overview of every Harness door, read One face, many brains.

Find the queue

Open your Approval Queue while you are signed in. When something is waiting, a small yellow pill in the page header shows how many items are waiting; tap it to go straight to the queue. At the top of the page, next to the Approval Queue heading, a badge counts what is pending.

What lands there

The card at the bottom of the page, How the approval queue works, says it plainly: when your agent meets something outside its guardrails, it pauses and puts the item here for your review. Each item belongs to one of seven kinds:

  • Messages: an email, text or other message your agent wants to send, and anything that fits none of the kinds below.
  • Calls: a phone call it wants to place.
  • Bookings: a calendar entry or booking.
  • Quotes: a quote, and anything that would charge, spend or take a payment.
  • Follow-ups: a follow-up it wants to send.
  • Scheduling: something it wants to schedule.
  • Refunds: a refund.

Above the list, All shows everything, and a button appears for each kind that has something waiting. Tap one to see only that kind.

How one item reads

Each item is a card. The bold line is the action, for example Send Email, with its kind beside it. A red Urgent badge marks an action that would spend money. Under it you read why your agent stopped, then the details it wants to use, laid out as labels and values, such as who the email goes to and its subject. The small line at the bottom says when it asked, which agent asked, and how long is left before the item runs out of time.

When a piece of work is on hold behind the item, the card says A run is paused here, waiting on your decision. The list is in order, and the page says so: Newest request first. The one at the bottom has waited longest — and runs out of time first.

The three buttons

Approve lets your agent go ahead, and the item leaves the queue. The page confirms it at the top. If a run was paused behind it, the message says your agent is continuing with it now, and what happened next shows under Recent decisions further down the page.

Later snoozes the item for one hour. The page says Snoozed for 60 minutes, the item leaves the queue, and it comes back on its own when the hour is up. Snoozing does not stop the item's clock: the time limit still counts from when your agent first asked. If less than an hour is left, the button's tip warns you that snoozing would let it lapse.

Reject asks before it stops anything. A small panel opens with Stop this before it runs? It tells you your agent will not carry out the action, and that nothing which already happened is undone; it only stops what was waiting here. You can type a reason in the optional box; your agent keeps it on the record. Then choose Yes, stop it, or Keep waiting to close the panel and leave the item where it was. After you reject, the page confirms it, and says your agent stopped there when a paused run was behind it.

Approve and Reject are final. There is no undo button on this page, and a decided item does not come back. If you change your mind after a Reject, ask your agent again.

When the clock runs out

Every item has a time limit, and the card shows how long is left. In the last six hours a yellow Expires in badge makes that plain. If nobody decides in time, the item expires: it leaves the queue, your agent does not carry it out, and a paused run behind it stops.

When nothing is waiting

An empty queue says Nothing needs you right now: your agent is working inside the limits you set, and if it ever wants to do something you asked to be consulted on, it stops and waits here until you decide.

If the page ever says We couldn't load your queue just now, that is on our side, and it does not mean the queue is empty: something may still be waiting on you. Loading the page decided nothing for you. Tap Try again to look once more.

Still stuck?

The longer documentation covers models, voice, knowledge, and workflows in depth.

Open the documentation