Secondary Action Button for Live Activities

Live Activities can now include a secondary action button beside the primary action.

This is useful for AI agent approvals, operational prompts, and webhook-driven workflows where you need to choose between two actions, like approving or denying an AI agent step, sending or cancelling an outreach message, retrying or pausing a job, or acknowledging or escalating an alert.

What's New

• New optional secondary_action field, supported for alert, progress, and segmented_progress Live Activities.
• Both buttons use the same open_url, webhook, and Apple Shortcut payload shapes.
• Use content_state.color to change the tint for both action buttons.

Example

This example shows an approval prompt with two webhook buttons. The body can contain whatever your backend needs, or it can be empty.

1
await activitysmith.liveActivities.stream("agent-approval", {
2
  content_state: {
3
    title: "Approval Needed",
4
    message: "Should I send the follow-up email to Brightlane?",
5
    type: "alert",
6
    color: "green",
7
    icon: {
8
      symbol: "sparkles",
9
      color: "green",
10
    },
11
    badge: {
12
      title: "Agent",
13
      color: "green",
14
    },
15
  },
16
  action: {
17
    title: "Send",
18
    type: "webhook",
19
    url: "https://agent.example.com/live-activity/approve",
20
    method: "POST",
21
    body: {
22
      approval_id: "approval_01JY3J7Q9S0P8M1V5PZK7DR4M2",
23
      decision: "send",
24
    },
25
  },
26
  secondary_action: {
27
    title: "Deny",
28
    type: "webhook",
29
    url: "https://agent.example.com/live-activity/deny",
30
    method: "POST",
31
    body: {
32
      approval_id: "approval_01JY3J7Q9S0P8M1V5PZK7DR4M2",
33
      decision: "deny",
34
    },
35
  },
36
});

Availability

Available now across the API, SDKs, and CLI.

This feature is available in the ActivitySmith iOS app version 1.12.0 and newer.