pushover

Pushover API Skill

Send push notifications to Android, iOS, and Desktop devices via the Pushover API. Uses a custom OpenAPI spec with restish and 1Password for credential injection.

CLI (restish) — Preferred

A pushover CLI wrapper is installed at ~/.local/bin/pushover. It uses restish with a hand-written OpenAPI spec and injects the app token + user key from 1Password automatically via op run.

Quick send (most common)

# Simple message
pushover send "Deploy complete"

# With title, priority, and sound
pushover send "Server down!" --title "Alert" --priority 1 --sound siren

# All send options
pushover send "message" \
  --title "Title" \
  --priority 1 \
  --sound cosmic \
  --url "https://example.com" \
  --url-title "Details" \
  --device iPhone-16-Pro \
  --html \
  --ttl 3600

GET endpoints (auto-injected token)

# Check message quota
pushover get-app-limits

# List available notification sounds
pushover list-sounds

# Check license credits
pushover get-license-credits

# Check emergency receipt status
pushover get-receipt-status RECEIPT_ID

POST endpoints (JSON input, auto-injected credentials)

# Validate user key
pushover validate-user '{}'

# Send via full JSON (token + user merged automatically)
pushover send-message '{"message":"Hello","title":"Test","priority":0}'

# Pipe JSON
echo '{"message":"Backup done","sound":"cashregister"}' | pushover send-message

# Cancel emergency notification
pushover cancel-receipt '{}' RECEIPT_ID

# Cancel by tag
pushover cancel-by-tag '{}' TAG_NAME

Full command list

Run pushover --help (or restish pushover --help) for all 18 commands:

Command	Description
send	Shorthand — send a notification with flags
send-message	Send a notification (JSON input)
validate-user	Validate a user or group key
get-app-limits	Check monthly message quota
list-sounds	List available notification sounds
send-glance	Push data to a Glances widget (Apple Watch)
get-receipt-status	Check emergency notification status
cancel-receipt	Cancel emergency notification retries
cancel-by-tag	Cancel emergency notifications by tag
list-groups	List delivery groups
create-group	Create a new delivery group
get-group	Get group info and members
add-user-to-group	Add a user to a group
remove-user-from-group	Remove a user from a group
disable-user-in-group	Disable a user in a group
enable-user-in-group	Re-enable a user in a group
rename-group	Rename a delivery group
migrate-subscription	Migrate a user key to a subscription key
assign-license	Assign a license credit
get-license-credits	Check remaining license credits