Deployed Apps

The Deployed Apps page in your workspace lists every application that has been installed and activated within your organization. Each app runs as a self-contained unit that coordinates one or more agents and skills to perform a specific business function.

App Cards

Each deployed app is displayed as a card showing:

• App name and icon — identifying the application at a glance.
• Status indicator — a colored badge showing the current state (Running, Stopped, Error, Deploying).
• Version — the currently deployed version number.
• Last active — timestamp of the app’s most recent activity.
• Department — the department the app is assigned to.
• Agent count — number of agents the app uses.

Click any app card to open its detail panel.

App Status Lifecycle

Apps move through the following states:

Status	Description
Deploying	The app is being provisioned. Agents and connections are being initialized.
Running	The app is fully operational and processing tasks.
Stopped	The app has been manually stopped. No tasks are processed.
Error	The app encountered a critical failure. Check logs for details.
Updating	A new version is being applied. The app remains available during rolling updates.

Starting and Stopping Apps

1. Navigate to Workspace > Deployed Apps.
2. Locate the app you want to control.
3. Click the three-dot menu (⋯) on the app card.
4. Select Start or Stop from the dropdown.
5. Confirm the action in the dialog that appears.

Caution

Stopping an app will immediately halt all its agents. Any in-progress tasks will be cancelled and moved to a failed state. Make sure no critical workflows are running before stopping an app.

Viewing Logs

Each app maintains a dedicated log stream. To access logs:

1. Click on the app card to open the detail panel.
2. Select the Logs tab.
3. Use the time range picker to narrow the log window.
4. Filter by log level: Info, Warning, Error, or Debug.

Logs include entries from every agent and skill execution within the app. Each log entry shows a timestamp, the originating agent, the skill that was executed, and the message body.

You can export logs as a CSV file for external analysis by clicking the Export button in the top-right corner of the log viewer.

App Settings

The Settings tab on an app’s detail panel lets you configure:

• Display name — customize how the app appears in your workspace.
• Assigned department — move the app to a different department.
• Auto-restart — enable automatic restart if the app enters an error state.
• Notification preferences — choose which events trigger alerts (errors only, all state changes, or none).
• Connection overrides — remap which connections the app uses (for example, switching from a sandbox Salesforce instance to production).
• Environment variables — set key-value pairs that are passed to the app’s agents at runtime.

Note

Changes to app settings take effect immediately for new task executions. In-progress tasks will complete using the previous configuration.

Redeploying and Updating

When a new version of an app is available in the Store, you will see an Update Available badge on the app card. Click it to review the changelog and apply the update. Updates use a rolling deployment strategy — the old version continues handling active tasks while the new version is provisioned.

To force a full redeploy of the current version (useful for clearing stale state), open the app settings and click Redeploy.

Removing an App

To uninstall an app from your workspace:

1. Stop the app first.
2. Open the app detail panel and go to Settings.
3. Scroll to the bottom and click Remove App.
4. Confirm the removal. This action is irreversible — all app-specific data, logs, and configuration will be deleted.