Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: say tag instead of kind in approval mode
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Mukund committed
Oct 15, 2026 at 15:02 UTC
4df2821f02c980232b0a7bb180c4768bc67f916e
1 file changed
+10
-10
docs/content/docs/approval-mode.mdx
+10
-10
@@ -24,18 +24,18 @@ List the toolkits the agent can use in `toolkits.enable`:
24
toolkits={"enable": ["gmail", "github"]}
25
```
26
27
-### 2. Choose what each kind of action does
27
+### 2. Choose what each tag does
28
29
-Every tool is tagged with the kind of action it takes:
29
+Every tool has a [tag](/docs/configuring-sessions#filtering-tools-by-tags) for the type of action it takes:
30
31
-| Kind | Tag |
31
+| Tag | Action |
32
|---|---|
33
-| Read | `readOnlyHint` |
34
-| Create | `createHint` |
35
-| Update | `updateHint` |
36
-| Destructive | `destructiveHint` |
33
+| `readOnlyHint` | Read |
34
+| `createHint` | Create |
35
+| `updateHint` | Update |
36
+| `destructiveHint` | Destructive |
37
38
-For each kind, choose one of:
38
+For each tag, choose one of:
39
40
- **Allow:** leave the tag out.
41
- **Ask first:** add the tag to `tags.require_approval`.
@@ -52,9 +52,9 @@ tags={
52
53
### 3. Override toolkits
54
55
-You can override step 2 for a toolkit, either by kind or by tool.
55
+You can override step 2 for a toolkit, either by tag or by tool.
56
57
-**By kind.** Set `tools.<toolkit>.tags`, the same way as step 2. This replaces the session-wide `tags` for that toolkit rather than adding to them, so list every kind you want it to ask about or block. For example, this lets GitHub's destructive actions run after the user approves them, rather than blocking them:
57
+**By tag.** Set `tools.<toolkit>.tags`, the same way as step 2. This replaces the session-wide `tags` for that toolkit rather than adding to them, so list every tag you want it to ask about or block. For example, this lets GitHub's destructive actions run after the user approves them, rather than blocking them:
58
59
```python
60
tools={