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 JSON content following this schema:

• verb: “poke” | “bite” | “punch” | “kick” | “wave” | “yell” | “hug” | “kiss” | “pet” optional default=“poke”
• urgent: boolean optional default=false

For example:

{
    "verb": "yell",
    "urgent": true
}

which 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.