From 6a0d75462470ca6f6decc132d58d30e9de275c38 Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Tue, 20 Oct 2026 08:10:52 +0000
Subject: [PATCH] docs: document quiet listings for automation

The automation guide did not identify quiet output for policies, settings, or approvals. List the returned identifiers and distinguish cloud policy output.
---
 content/manuals/ai/sandboxes/workflows/automation.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/content/manuals/ai/sandboxes/workflows/automation.md b/content/manuals/ai/sandboxes/workflows/automation.md
index ea653a325f..78567684a2 100644
--- a/content/manuals/ai/sandboxes/workflows/automation.md
+++ b/content/manuals/ai/sandboxes/workflows/automation.md
@@ -86,6 +86,14 @@ $ sbx prune --dry-run --format yaml
 are rejected. `sbx events --json` emits newline-delimited JSON, and
 `sbx mcp auth --format text|json` uses command-specific formats.
 
+For lists of identifiers without table headings, use `--quiet` or `-q`:
+
+| Command | Output |
+| --- | --- |
+| `sbx policy ls -q` | Local rule IDs. With `--cloud`, network patterns instead. |
+| `sbx settings ls -q` | Setting keys. |
+| `sbx policy approval ls -q` | Approval IDs. |
+
 ### Update scripts for v0.48.0
 
 {{< copy-as-prompt instruction="Update this repository's Docker Sandboxes CLI usage for v0.48.0 using the migration reference below. Inspect scripts and documentation, update affected commands and output parsers, and verify the changes. Preserve unrelated behavior." >}}