Running apps

After creating an app, you can run it on-demand, share it, and manage access across your organization.

On-demand app runs are useful for validation, one-off processing tasks, and collaboration before setting up deployments. You can troubleshoot issues or monitor performance by viewing detailed logs.

Running apps

You can run accessible apps from the Hub on demand.

1. From the Hub, select the app you want to run, then click Run app.

   If the app includes sample files, you can optionally preview app functionality with a sample run by selecting Use sample files. Otherwise, select Upload files.

2. If you’re an organization member, verify the workspace you want to run the app in.

   Run results are available only in the selected workspace, and are viewable by all members of that workspace.

3. If the app includes custom or secret keys, specify runtime values for the keys in the Advanced settings section.

4. Select files to process and click Run.

   When the run completes, view results from the App runs tab.

Deleting app runs

You can delete app runs individually or in bulk to satisfy data retention or confidentiality requirements.

Deleting app runs permanently deletes associated results, log files, and database entries. By default, source files uploaded for the run are also deleted, but you can opt to keep them.

1. From the Hub, open the app you want to delete runs from.

2. Select the App runs tab.

3. Indicate which runs you want to delete:

   • Hover over a single run, click the overflow icon , and select Delete run.

   • Select the checkboxes for multiple runs and click Actions > Delete runs.

4. Select if you want to keep source files and click Delete.

Sharing apps

You can share apps you create with other AI Hub users by managing version visibility for individual app versions.

App versions can be either private—visible only to you and organization admins—or shared. Sharing functionality differs based on your AI Hub subscription.

• Community App sharing is enabled with the app URL. Any AI Hub user with the URL can view and use shared versions of your app. Community apps aren’t shared in the Hub.

• Commercial & Enterprise App sharing is enabled through organization membership. Any member of your organization can view and use shared versions of your app and see run results in any workspace they have access to.

The account that initiates an app run is responsible for any consumption units used.

Version visibility is indicated on each app’s Versions tab. To change version visibility for a given app version, hover over the version and click the edit icon .

Viewing logs

Logs provide detailed insights into app and deployment runs, helping you troubleshoot issues, monitor performance, and understand how your documents are being processed.

You can access logs from the runs page of any app or deployment. To view or download a log, hover over the run you want to investigate, click the overflow icon , then select View logs or Download logs. You can download logs in CSV or JSON format.

Each log entry includes a timestamp, log level, and detailed message. Log levels indicate the severity and type of information.

• INFO — General operational information, such as processing status and model calls.

• WARNING — Potential issues that don’t stop execution but might require attention.

• ERROR — Serious problems that might cause failures or unexpected behavior.

When troubleshooting, focus on error and warning messages first, as they often indicate the root cause of issues. Info messages provide context about standard operations and can help trace document flow through your application.

If an app uses custom or secret keys, logs include a Runtime configurations tab showing the key values used. For secret keys, only the key names are displayed, not the actual secret values.

Advanced automation apps are custom apps created by Instabase to address complex enterprise use cases.

Advanced automation apps are available from the Hub and tagged with Advanced. You can test, run, and deploy advanced automation apps just like any other app, but you can’t edit them or access an underlying automation project. Similarly, advanced automation apps are created with a specific AI runtime version, but you can’t update AI runtime for advanced automation apps like you can with standard apps.

If required for your use case, advanced automation apps might be designed with multiple review checkpoints. In this case, each review must be closed before the run can proceed or complete.