Skip to content

Actions & approvals

This is the most important page in these docs.

Gray drafts, summarizes, reads, and prepares freely. Gray asks before it sends, spends, deletes, or changes anything that touches the real world.

This is not a setting. It’s how Gray is built.

A decision card appears in the Talk feed. It shows:

  • What Gray wants to do (“Send this email to alice@acme.com”)
  • Why (“You asked me to follow up on the contract”)
  • The exact payload (the email body, the SQL, the API call)
  • Two buttons: Approve and Cancel

Approve and Gray runs it. Cancel and nothing happens — Gray asks what to do instead.

  • Sending email or messages
  • Posting publicly (social, chat channels)
  • Spending money or moving money
  • Deleting or modifying files
  • DNS or infrastructure changes
  • Anything Gray flags as irreversible
  • Reading data you’ve connected (mail, files, calendar, etc.)
  • Drafting, summarizing, searching, analyzing
  • Saving things to your own Files tab
  • Anything Gray can undo for you

You can configure standing rules in Settings → Approvals — for example “always approve sending emails to my own address” or “always ask before posting on Twitter.”

Default is conservative: ask for everything consequential.