STACK
MENU
DOCS / CONTROLS / THE TRUST SWITCH

The trust switch

How you choose whether your agents' purchases and orders wait for you, for the whole account or for one agent. The switch works with controls on or off, and it is free.

The two settings

  • trust_agents - "trust my agents". A new account starts here.
  • ask_first - you are asked before the things listed below.

The account has one setting, and an agent can have its own. An agent without its own follows the account.

What it changes

  • Card purchases are not on this switch: you approve each one on your own device.
  • Wallet payments. On trust_agents, a payment is sent. On ask_first, it waits for you, and the agent sends it again once you approve.
  • Orders on your own supplier account, such as print on demand. On trust_agents, an order is placed as soon as the agent's budget covers it. On ask_first, it waits for you.
  • Changes made with your own API key. On trust_agents, a change that would otherwise ask for your approval goes through when it is made with the owner's own key. On ask_first, it asks.

These always apply, whatever the switch says: your credit and an agent's budget still refuse what they cannot cover, a policy that holds an action still holds it, and the changes that need a signed-in browser still need one.

Read it

prompt
Is my account on ask first or trust my agents?

The client calls stack_get_trust. The answer says what is set, what is in effect, and whether that comes from the agent, the account or the default.

bash
npx @getstackrun/cli trust get
npx @getstackrun/cli trust get agt_123

Change it

bash
# The whole account.
npx @getstackrun/cli trust set ask_first

# One agent.
npx @getstackrun/cli trust set trust_agents agt_123

# Let that agent follow the account again.
npx @getstackrun/cli trust clear agt_123
typescript
await stack.trust.set('ask_first');
await stack.trust.set('trust_agents', 'agt_123');
await stack.trust.clear('agt_123');
  • Only the owner or an admin changes it. An agent cannot read or change its own.
  • Going to ask_first applies at once.
  • Going to trust_agents asks for your approval first, in the chat or on the approval page.
  • The tool is stack_set_trust.

When it is refused

  • 403 GOVERNANCE_APPROVAL_REQUIRED - you are widening trust. Approve it, then send the change again.
  • 403 FORBIDDEN - an agent, or a member who is not an admin, tried to change it.

Reference

To hold specific actions whatever the switch says, write a rule: see Policies and Approvals.

The trust switch | Docs