Actions add buttons to an event card. When someone clicks a button, Operational sends a request to your server.

const e = {
  name: "high risk login detected",
  avatar: "🚨",
  category: "security",
  actions: [
    {
      url: "https://api.your-app.com/ops/action",
      buttonText: "Suspend account",
      key: "suspend_account",
      meta: { userId: "usr_123" },
      expireIn: 120,
    },
    {
      url: "https://app.your-app.com/admin/usr_123",
      buttonText: "Open user profile",
      external: true,
    },
  ],
};

A simple server handler:

app.post("/ops/action", async (req, res) => {
  const { event } = req.body;
  if (event.key === "suspend_account") {
    await suspendUser(event.meta.userId);
  }
  return res.status(200).json({ ok: true });
});

Rules to remember:

1. url and buttonText are required.
2. buttonText must be 48 characters or less.
3. key is required unless external: true.
4. expireIn defaults to 10080 minutes (7 days).