DevelopersTerminal
Inbox CLI reference
List and resolve durable approvals and decisions.
On this page
Use this page to inspect every public atoi inbox command, its accepted flags, and one runnable example. Return to the CLI reference index to choose another command group.
atoi inboxList and resolve durable approvals and decisions.
| Command | What it does |
|---|---|
atoi inbox list | List decisions that need attention. |
atoi inbox approve | Approve one exact Inbox request. |
atoi inbox deny | Deny one exact Inbox request. |
atoi inbox snooze | Hide an Inbox item until a future time. |
#inbox list
List decisions that need attention.
atoi inbox list [--status <status>] [--limit <n>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--status | string | Filter by Inbox status. | ||
--limit | number | Limit the number of returned records. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run inbox list
atoi inbox list --status unread --json
{
"tool": "atoi_inbox",
"arguments": {
"action": "list",
"status": "unread",
"limit": 10
}
}
#inbox approve
Approve one exact Inbox request.
atoi inbox approve <item-id> [--item <item-id>] [--request <request-id>] --confirm
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--item | string | Select an Inbox item by id instead of a positional id. | ||
--request | string | Bind the decision to an exact approval request id. | ||
--confirm required | boolean | Confirm the exact consequential action after you inspect its target. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run inbox approve
atoi inbox approve inb_4d6p --request req_2n8s --confirm --json
{
"tool": "atoi_inbox",
"arguments": {
"action": "approve",
"item_id": "inb_3r7d",
"request_id": "req_6p2n",
"confirmation": true
}
}
#inbox deny
Deny one exact Inbox request.
atoi inbox deny <item-id> [--item <item-id>] [--request <request-id>] --confirm
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--item | string | Select an Inbox item by id instead of a positional id. | ||
--request | string | Bind the decision to an exact approval request id. | ||
--confirm required | boolean | Confirm the exact consequential action after you inspect its target. | ||
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run inbox deny
atoi inbox deny inb_4d6p --request req_2n8s --confirm --json
{
"tool": "atoi_inbox",
"arguments": {
"action": "deny",
"item_id": "inb_3r7d",
"request_id": "req_6p2n",
"confirmation": true
}
}
#inbox snooze
Hide an Inbox item until a future time.
atoi inbox snooze <item-id> [--item <item-id>] [--until <timestamp-ms> | --hours <hours>]
| Flag | Type | Default | Values | What it does |
|---|---|---|---|---|
--item | string | Select an Inbox item by id instead of a positional id. | ||
--until | number | Set the future Unix timestamp in milliseconds. | ||
--hours | number | 3 | Snooze for this many hours. | |
--json | boolean | false | Emit the canonical JSON envelope. | |
--ndjson | boolean | false | Emit one canonical JSON envelope per line. | |
--format | string | text | text, json | Choose human text or the JSON envelope. |
--help -h | boolean | Show command help. |
#Run inbox snooze
atoi inbox snooze inb_4d6p --hours 4 --json
{
"tool": "atoi_inbox",
"arguments": {
"action": "snooze",
"item_id": "inb_3r7d",
"request_id": "req_6p2n",
"snoozed_until": 1788098400000
}
}
Was this useful?