PushWard


Schemes	`pushward://`
Cargo feature	`service-pushward`
Service	https://pushward.app/
Body formats	`text` (first is the default)
Attachments	no
Title length	256 characters
Body length	3,000 characters
Body lines	unlimited
Request throttle	none
Vendor URLs accepted	no

URL formats

{schema}://{apikey}

{schema} is one of pushward://.

URL tokens

Token	Meaning	Type	Required	Default	Notes
`{apikey}`	Integration Key	string	yes		secret; must match `^hlk_[A-Za-z0-9]+$`

Query parameters

Parameter	Meaning	Type	Default	Notes
`apikey`	Integration Key	string		sets `{apikey}`
`failure`	Failure Level	choice	`time-sensitive`	one of `passive`, `active`, `time-sensitive`, `critical`
`info`	Info Level	choice	`active`	one of `passive`, `active`, `time-sensitive`, `critical`
`level`	Level	choice		one of `passive`, `active`, `time-sensitive`, `critical`
`success`	Success Level	choice	`active`	one of `passive`, `active`, `time-sensitive`, `critical`
`volume`	Volume	float, 0 to 1
`warning`	Warning Level	choice	`time-sensitive`	one of `passive`, `active`, `time-sensitive`, `critical`

The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.

Examples

Accepted URLs (tokens are fake):

pushward://hlk_abc123
pushward://?apikey=hlk_abc123
pushward://hlk_abc123?level=critical&volume=0.8
pushward://hlk_abc123?info=passive&failure=crit
pushward://hlk_abc123?level=passive&info=critical

Rejected URLs:

pushward://
pushward://invalid
pushward://hlk_abc123?info=invalid
pushward://hlk_abc123?level=invalid

Send one from the command line:

mercurio -t 'Backup' -b 'Finished in 42s' 'pushward://hlk_abc123'

Notes

PushWard (pushward://): push notifications through PushWard.

Differences with Apprise

Apprise accepts volume=nan, while mercurio does not.

Keyboard shortcuts