Update Sets

What are Update Sets?

Update Sets are bundles of configuration changes that can be exported from one StackFlow instance and imported into another. They are the recommended mechanism for promoting configuration changes from development to staging to production environments. Update Sets capture workflow definitions, SLA policies, notification templates, feature flag configurations, and system properties — but not data records.

⚙️ Minimum Requirements

DynamoDB: StackFlow_UpdateSet table with PK updateSetId and GSI on status
S3: stackflow-update-sets-373544523367 bucket for storing update set exports
IAM: StackFlowAPIRole with s3:PutObject, s3:GetObject on the update sets bucket
Role: Applying update sets requires super_admin JWT claim

Note: Update Sets track configuration-layer changes, not data changes. Incidents, CIs, users, and other operational data are NOT included in Update Sets.

Creating an Update Set

Navigate to Admin → Update Sets → New Update Set. Give the update set a descriptive name (e.g., "v2026.1-Q2-SLA-Policy-Changes") and select the target environment. All subsequent configuration changes in the current session will be captured in this update set.

curl -X POST https://your-instance.stackflow-tech.com/prod/api/admin/update-sets   -H "Authorization: Bearer $ADMIN_TOKEN"   -H "Content-Type: application/json"   -d '{
    "name": "v2026.1-Q2-SLA-Policy-Changes",
    "description": "Updated P1 resolution SLA from 4h to 2h per new SLA agreement",
    "target_environment": "production"
  }'

Capturing Changes

Once an Update Set is active, all configuration changes made by any administrator in the current tenant are automatically recorded. Changes are captured as JSON diffs and stored with a description of what was changed, who changed it, and when.

Configuration Type	Captured
Workflow definitions	Yes
SLA policies	Yes
Notification templates	Yes
System properties	Yes
Feature flags	Yes
Catalog items	Yes
User accounts	No
Incident/change data	No

Reviewing and Exporting

Before exporting, review all captured changes in the Update Set preview. The preview shows the full JSON diff for each change, allowing you to verify that all intended changes are captured and no unintended changes are included. Export the Update Set as a signed JSON package.

Importing to Another Instance

Import the exported JSON package into the target instance via Admin → Update Sets → Import. The import process performs a pre-flight check to identify any conflicts with the target instance's current configuration. Conflicts must be resolved before the import can complete.

# Import via API
curl -X POST https://prod-instance.stackflow-tech.com/prod/api/admin/update-sets/import   -H "Authorization: Bearer $ADMIN_TOKEN"   -H "Content-Type: application/json"   -d @update-set-v2026.1-Q2.json

← Previous

System Properties

Platform-wide settings

Incident Management

Create, manage, and resolve incidents