Skip to main content
POST
/
live-activity
/
update
Node
import ActivitySmith from "activitysmith";

const activitysmith = new ActivitySmith({
  apiKey: process.env.ACTIVITYSMITH_API_KEY,
});

await activitysmith.liveActivities.update({
  activity_id: "pLAr-Hnq9ZFW4sxlk43Lhbuok4GLh7UW",
  content_state: {
    title: "Nightly database backup",
    subtitle: "upload archive",
    number_of_steps: 3,
    current_step: 2,
  },
});
{
  "success": true,
  "activity_id": "pLAr-Hnq9ZFW4sxlk43Lhbuok4GLh7UW",
  "devices_notified": 2,
  "devices_queued": 0,
  "timestamp": "2026-01-28T09:57:26.056Z"
}

Documentation Index

Fetch the complete documentation index at: https://activitysmith.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to update an existing Live Activity by activity_id.
  • metrics: send the latest metrics array.
  • stats: send the latest metrics array for up to 8 labeled values.
  • segmented_progress: send the latest current_step and, if needed, an updated number_of_steps.
  • progress: send the latest percentage, or value with upper_limit.
  • action is optional if you want to set or replace the Live Activity button.
  • type is optional on update if the existing Live Activity already has a type.
For segmented_progress, you can update both current_step and number_of_steps. Use this when the workflow gains or loses steps after the activity has already started.

Authorizations

​
Authorization
string
header
required

Required. Include Authorization: Bearer ask_123456789 in every request. Replace ask_123456789 with your API key.

Body

application/json

Update an existing Live Activity by activity_id.

​
activity_id
string
required
​
content_state
object
required

Update payload requires title. For segmented_progress include current_step and optionally number_of_steps. For progress include percentage or value with upper_limit. For metrics and stats include a non-empty metrics array. Type is optional when updating an existing activity. You can increase or decrease number_of_steps during updates.

​
action
object

Optional single action button shown in the Live Activity UI.

Response

Live Activity updated (or queued)

Returned after a Live Activity update is sent or queued.

​
success
boolean
required
​
activity_id
string
required
​
timestamp
string<date-time>
required
​
devices_queued
integer
​
devices_notified
integer