Preview: SendMock has no stable release yet. These docs follow develop.

CLI reference

Push commands

sendmock push clear

Delete every push notification, or one project's.

sendmock push clear [flags]
FlagTypeDescription
--project <project>string
Only this project's notifications (its key); every project's when not set.Example: shop
--device-token <device-token>string
Only notifications to this device token.Example: dQw4w9WgXcQ:APA91bE1
--provider <provider>string
fcm, expo or onesignal.One of: fcm, expo, onesignalExample: fcm
--status <status>string
sent or failed.One of: sent, failedExample: sent
--yesboolean
Confirms a destructive command; without it the command stops.

Example

sendmock push clear --project shop --device-token dQw4w9WgXcQ:APA91bE1 --yes

Output with --json: nothing. Exit codes: 0, 1, 2.

API
DELETE/api/v1/push
MCP tool
sendmock_push_delete_all
In the app
Push > Clear all

sendmock push delete

Delete one push notification.

sendmock push delete <pushId> [flags]
ArgumentTypeDescription
<pushId>requiredstring
The notification's id, from GET /api/v1/push.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D
FlagTypeDescription
--yesboolean
Confirms a destructive command; without it the command stops.

Example

sendmock push delete 01JB7T9Q2R5W8X3Y6Z1A4B7C9D --yes

Output with --json: nothing. Exit codes: 0, 1, 2.

API
DELETE/api/v1/push/{pushId}
MCP tool
sendmock_push_delete
In the app
Push > open a notification > Delete

sendmock push list

Push notifications, newest first, with filters.

sendmock push list [flags]
FlagTypeDescription
--cursor <cursor>string
The next_cursor of the previous page.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D
--limit <limit>integer
Items per page, 1 to 200 (default 50).Example: 50
--project <project>string
Only this project's notifications (its key); every project's when not set.Example: shop
--device-token <device-token>string
Only notifications to this device token.Example: dQw4w9WgXcQ:APA91bE1
--provider <provider>string
fcm, expo or onesignal.One of: fcm, expo, onesignalExample: fcm
--status <status>string
sent or failed.One of: sent, failedExample: sent

Example

sendmock push list --cursor 01JB7T9Q2R5W8X3Y6Z1A4B7C9D --limit 50

Output with --json: PageOf_PushNotification. Exit codes: 0, 1, 2.

API
GET/api/v1/push
MCP tool
sendmock_push_list
In the app
Push

sendmock push show

One push notification with its request and answer.

sendmock push show <pushId>
ArgumentTypeDescription
<pushId>requiredstring
The notification's id, from GET /api/v1/push.Example: 01JB7T9Q2R5W8X3Y6Z1A4B7C9D

Example

sendmock push show 01JB7T9Q2R5W8X3Y6Z1A4B7C9D

Output with --json: PushNotification. Exit codes: 0, 1, 2, 3.

API
GET/api/v1/push/{pushId}
MCP tool
sendmock_push_get
In the app
Push > open a notification

sendmock push wait

Wait until a matching push notification arrives; 408 on timeout.

sendmock push wait [flags]
FlagTypeDescription
--device-token <device-token>string
The device token.Example: dQw4w9WgXcQ:APA91bE1
--project <project>string
Only this project's notifications (its key); every project's when not set.Example: shop
--since <since>string
Only notifications sent after this time (default: 30 s ago).Example: 2026-11-07T10:00:00Z
--timeout <timeout>string
How long to wait, e.g. 10s (default 10s, at most 60s).Example: 10s

Example

sendmock push wait --device-token dQw4w9WgXcQ:APA91bE1 --project shop

Output with --json: PushNotification. Exit codes: 0, 1, 2, 4.

API
GET/api/v1/wait/push
MCP tool
sendmock_push_wait
In the app
Push (new notifications appear live)