Notifications from the CLI
Found this helpful? Share it:
Found this helpful? Share it:
The idapt notification commands read your inbox and send
notifications to workspace members, all with your CLI credentials 🔔
| Command | What it does |
|---|---|
idapt notification list | List notifications. |
idapt notification preferences | Get notification preferences. |
idapt notification update-preferences | Bulk update notification preferences. |
idapt notification config | Get notification config (toasts, sound, quiet hours). |
idapt notification update-config | Update notification config. |
idapt notification get | Get a notification. |
idapt notification send | Send a notification. |
idapt notification update | Update a notification (mark read, …). |
idapt notification delete | Delete a notification. |
idapt notification read-all | Mark all notifications read. |
Run idapt help notification <verb>for the exact
arguments of any of these.
Pass the recipients and content as structured input. target is one of all_members, admins, or owner, or supply explicit recipient_ids instead:
idapt notification send --workspace-id <workspace-id> --json '{
"target": "all_members",
"title": "Build passed",
"message": "Staging deploy succeeded",
"dedup_key": "build-1421"
}'A dedup_key makes retries idempotent for 24 hours per
recipient. A single send to many people counts as one notification.
You can send up to 100 notifications per 24 hours.
The response includes a resolved deep_link with a kind, path, and url, so you can
drop the link straight into a log.
Attach a deep link so recipients land on the right place from the
bell, an email button, or a push action. The supported kinds are chat, file, workspace, agent, computer, settings, billing, usage, support-ticket, hub, and home. Run idapt help notification send for the exact fields each
kind takes.
A deep link does not grant access. Recipients sign in as usual and meet the normal permission checks at the destination.
Manage delivery channels and quiet hours with the preferences and config verbs above. Quiet hours mute email and push, while in-app notifications still land in the bell. Three events always break through: a computer that auto-terminated, usage crossing 90%, and a computer workflow error.
Related articles
Notifications API
Send notifications to workspace members and manage your inbox programmatically.
Notifications over MCP
Send notifications from Claude, Cursor, or any MCP-compatible tool.
Command reference
The idapt <resource> <verb> grammar, how to discover any command from the terminal, and the full command list.
Was this helpful?