Approving and Denying Agent Actions
When a policy calls for a person, HYPR AgentPass™ holds the action and asks you. The agent waits, so nothing reaches the provider until you decide.
Set up your passkey first. See Setting Up Your Approval Passkey.
What Reaches You
A request arrives as a notification on your phone. Opening it shows what you need to decide:
- Which agent is asking
- What it wants to do, with a preview of the content where the action carries any, such as the message it would send
Read the agent name and the action together before you decide. This step exists to catch an agent acting on a target you do not recognize.
On iPhone, tapping a request under Needs you, or opening its notification, shows the Review request screen:
- Time left. A red banner counts down, for example 4m 12s remaining, and reads Expired once the request expires.
- The request. A card shows what the agent wants to do and who it is waiting on, and the policy that held it when there is one. Its icon marks the kind of request: a shield for a policy hold, a raised hand when the agent raised the request itself, and a lock when you need to sign in to a connected service.
- Your decision. The note This approval will be signed with your passkey. sits under the card, and Deny and a wider Approve sit side by side at the bottom of the screen. For a sign-in to a connected service, the button reads Authenticate, and the note does not appear.
You can also decide the same request in the console, under Approvals. See Approvals in the Console.
Your Options
Your answer decides what happens to the agent.
| You choose | What happens to the agent |
|---|---|
| Approve | The gateway releases the action, and the agent's traffic continues to the provider. Your phone asks for your face, fingerprint or PIN to confirm |
| Deny | The gateway stops the action, and the agent does not reach the provider. On Android, you confirm once more. On iPhone, it takes effect immediately |
A request the agent raised itself is decided the same way, with Approve or Deny. To reply to an agent in words, write to it in its conversation. See Having Conversations with Your Agent.
When your organization requires signed approvals, approving is signed with your passkey. The record therefore shows the decision was yours, not merely that someone with access clicked a button.
Requests Do Not Wait Forever
Each request stays open for a limited time. If it passes without an answer, the request expires, and the action does not proceed. Expiry is never a silent approval.
The agent is told to ask again, instead of being left waiting. An expired request therefore becomes a fresh notification, not a stuck agent.
Requests to reauthorize a connector are deliberately short-lived. Answer those promptly, or expect a new one.
Onboarding Approvals Are Time-Limited
Approving an agent's first connection grants it access for a period, not permanently. When that period ends, the agent's next request is held again, and a new approval reaches you as a re-onboarding request. Answer it the same way, and the agent resumes.
That is why an agent you approved last month can ask again without anything having gone wrong.
To withdraw an onboarding approval before it runs out, revoke it in the console. The agent's next request must onboard again. See Revoke an Approval.
Turning an Agent Off
You can turn off an agent you own from the mobile app or the console, without waiting for it to ask you something. Turn an agent off when it is behaving in a way you did not intend, and you want it stopped now, not at its next approval.
You can turn it back on only if you turned it off yourself. When an administrator turned it off, ask them to turn it back on. See Who Can Turn an Agent Off and On.
Turn an Agent Off on iPhone
On iPhone, the switch is in the agent's detail screen, on the card that reads Agent is on or Agent is off. In a conversation with the agent, tap + next to the message box: the switch is at the top of the menu that opens. On the home screen, tap ⋯ on the agent's tile, or touch and hold the tile, and choose Turn off agent or Turn on agent.
Turn an Agent Off in the Console
- Open Agents. You see the agents you supervise. To list only the agents that run on people's computers, choose Local in the filter above the list.
- In the agent's row, click ⋮, then Turn off.
- Optional: In Reason (optional), say why. The reason is recorded with your name.
- Click Turn off. Keep it on closes the dialog without a change.
The agent's status changes to off. To turn it back on, click ⋮ in its row, then Turn on. When the menu entry is grayed out, hover over it for the reason, such as an agent someone else turned off. See Turning Off an Agent.
What Turning Off Does
Once an agent is off, the gateway refuses its calls. A request already in progress when you flip the switch is allowed to finish. Its settings, history and assignments are kept.
What the App Tells You
When you turn an agent off, the app tells you what the gateway took back. On iPhone the message appears under the switch.
| Agent | What the message says |
|---|---|
| An agent on a workstation, such as Claude Code or Codex CLI | Agent disabled. followed by what was cut off: how many channel sessions were revoked, what happened to the agent's live connection, and how many AgentCore sessions ended, when there were any. For example: Agent disabled. 2 channel sessions revoked · live connection closed |
| A cloud agent | Agent disabled. New sessions are blocked and running sessions are being interrupted. |
The live connection is the channel the agent uses to receive your messages during a conversation. The message reports it in one of three ways:
| The message says | Meaning |
|---|---|
| live connection closed | The gateway closed the agent's live connection |
| live connection closing within 30 s | The connection is being closed and is gone within 30 seconds |
| no live connection | The agent had no live connection open |
When the message reads only Agent disabled., the agent is off and the gateway reported no further detail.
Turning an agent back on shows no message. The switch and the agent's status show that it is on.
Who Turned It Off
While an agent is off, its detail screen shows who switched it off and when, for example Disabled by grace.hopper@hb.com followed by how long ago it happened. The line appears when the gateway has recorded who made the change. After you turn an agent off yourself, it appears the next time the agent list refreshes.
When the Switch Does Not Move
If the gateway refuses the change, the agent keeps its previous status and the app says why.
| The app says | What it means | What to do |
|---|---|---|
| You don't manage this agent, so you can't switch it. | The agent is not one you own or supervise | Ask the agent's owner or your administrator to change it |
| This agent is in a conflicted state and can't be switched. | The gateway is holding the agent in a state that blocks status changes | Ask your administrator to review the agent |
| Couldn't change the agent's status. | The change did not go through | Try again |
When a Session Is Paused for Review
Besides a single held action, a whole session can be paused for review. A paused session runs no tools until someone authorized releases it. See Pausing and Stopping a Session.
A pause reaches you only when your organization sends pauses to the agent's supervisor. That is the Escalate a pause to setting under Guardrails › Settings, set to supervisor. By default, the setting is soc, and pauses go to the SOC distribution list on the same page. A pause for an agent with no assigned supervisor also goes to that list. See Escalation and Signed Resume.
When a pause reaches you, it arrives the same way an approval does. It asks you to resume the session, and says why the session was paused and what evidence led to it. It also states what you attest to by approving: that you reviewed the reason the session was frozen, and accept responsibility for it continuing. Two rules shape your decision:
- You are the reviewer the pause waits on. The agent running the session cannot lift its own pause. As its assigned supervisor, you are the person who can.
- Your passkey signs the decision. Resuming states that you have looked and are releasing the session, and the signature records that the decision was yours. If you decline, the session stays paused until its time limit passes.
A pause that no one answers within its time limit resolves on its own: the session resumes or ends, depending on your organization's setting. See If No One Responds.
Related
- Setting Up Your Approval Passkey — enroll before approvals can reach you
- Policies — what decides that an action needs you
- Turning Off an Agent — every way to stop an agent, and what stops straight away
- Pausing and Stopping a Session — what a session pause freezes, and what the developer sees
- Viewing the Request Log — what happened after you decided