---
title: "tool si.act.capture_rule"
description: "the rule: the rule, ready or not ready with the reason."
section: reference
address: /reference/tools/si-act-capture_rule
contract: 0476e35e6e275db5
---

# tool si.act.capture_rule

the rule: the rule, ready or not ready with the reason.

[figure: Over MCP, si.act.capture_rule takes CaptureRuleInput and returns a card whose body is CaptureRule.]

the rule, ready or not ready with the reason. The call needs the act grant at the user rung.



| | |
|---|---|
| input | [CaptureRuleInput](/concepts/captureruleinput) |
| result | a card whose body is [CaptureRule](/concepts/capturerule) |
| read-only | no |
| destructive | yes |
| card address | `ui://scale-intelligence/cards/CaptureRule` |
| HTTP route | [`/v1/act/capture_rule`](/reference/act/capture_rule) |





| field | type | required | note |
|---|---|---|---|
| `platform` | `text` | yes |  |
| `mode` | `one of on my say-so \| on my own submit \| ask me on this platform \| every page I open \| never` | yes |  |
| `way` | [AccessMethod](/concepts/accessmethod) | no |  |
| `default_scope` | `one of this item \| this thread \| this channel as shown \| this page \| this meeting \| my outbound message` | yes |  |
| `never_captured` | `[text]` | yes | addresses or kinds |
| `redactions` | [RedactionRule](/concepts/redactionrule) | no | the person's own |
| `browser_grant` | `one of given \| not given \| not needed` | no | the browser's standing host permission for the platform as the extension found it when the rule was written: asked of the person for every page I open, and not needed for the other modes; absent when the rule is written from a surface that is not the browser |