The Poke extension allows an actor to send a generic notification to another, to get a user's attention.

On the actor:

"extensions": {
    "https://pawpub.entities.org.uk/extension/poke": "https://social.example/actor/1/poke",
    ...
}

Another actor can now send an authenticated POST request (using the X-PawPub-Actor header) to the listed endpoint with application/x-www-form-urlencoded form content, with verb set to one of the allowed verbs (or by default “poke” if not specified) and urgent either set or not set.¹⁾

The allowed verbs are:

• poke
• bite
• punch
• kick
• wave
• yell
• hug
• kiss
• pet

POST /actor/132/poke HTTP/1.1
Host: antisocial.example
Authorization: Bearer ...
X-PawPub-Actor: https://social.example/actor/1
Content-Type: application/x-www-form-urlencoded
 
verb=yell&urgent=1

This would show the receiving actor a notification along the lines of “[user] yelled at you urgently” and possibly also indicate that the notification has urgent priority if the user's system allows.