---
title: "CaptureRuleInput"
description: "a person's capture rule to write: the platform, the mode, the way, the default scope, the never list and the person's redactions"
section: concepts
address: /concepts/captureruleinput
contract: 0476e35e6e275db5
---

# CaptureRuleInput

a person's capture rule to write: the platform, the mode, the way, the default scope, the never list and the person's redactions

[figure: CaptureRuleInput is a value at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | value |
| scope | none |
| key | none |
| store | none |
| family | harness |



## Fields


| 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 |



## Routes that use it
- [`/v1/act/capture_rule`](/reference/act/capture_rule) takes it as input