> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-business-apps.md).

# Work with Business Apps

Create, edit, publish, and manage preview versions of custom apps for your Kizen business.

{% hint style="success" %}
**Audience:** Administrators, developers, solution architects

**Purpose:** Explains how to work with business apps in Kizen
{% endhint %}

## Overview

*Business apps* are Kizen apps built for a specific Kizen business. They have the same kinds of functionality as marketplace apps, and you build them with the same components. However, unlike marketplace apps, business apps are available only to the team members of the associated business. Also unlike many marketplace apps, you create business apps exclusively through an agent-assisted development workflow, either directly in Kizen with our own KiCode agent or in the coding agent of your choice.

A business app in Kizen can be in the preview stage or the published stage:

* **Preview.** The business app is under active development.
* **Published.** The business app is released. The published version of the app is available to everyone in the business.&#x20;

A newly created business app begins in the preview stage. You must publish it to make it available to your business. However, after the app is published, any team member with the necessary permissions can edit it and thus create a new preview. Publish the new preview to replace the currently published app. Kizen retains the app's version history, so you can effectively revert to an earlier version by deleting the subsequent published versions.&#x20;

Find your business apps under the Develop tab of the App Marketplace (see Figure 1.)

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Fl6GIx6culbYlnK8xjBXx%2Fappdev_businessapps_develop.png?alt=media&amp;token=2cf3408b-c7b2-43b8-9cdc-bb9af9fea041" alt="The Develop tab of the App Marketplace displays all the business apps for the current business." width="563"><figcaption><p><strong>Figure 1:</strong> The Develop tab of the App Marketplace.</p></figcaption></figure></div>

This topic covers the following tasks:

* [Set permissions for business apps](#set-permissions-for-business-apps)
* [Review your business apps](#review-your-business-apps)
* [Inspect the details of a business app](#inspect-the-details-of-a-business-app)
* [Create a business app](#create-a-business-app)
* [Edit a business app](#edit-a-business-app)
* [Publish a business app](#publish-a-business-app)
* [Configure a published business app](#configure-a-published-business-app)
* [Disable a published business app](#disable-a-published-business-app)
* [Re-enable a disabled business app](#re-enable-a-disabled-business-app)
* [Switch to a preview version of a business app](#switch-to-a-preview-version-of-a-business-app)
* [Switch to the published version of a business app](#switch-to-the-published-version-of-a-business-app)
* [Delete a preview version of a business app](#delete-the-preview-version-of-a-business-app)
* [Delete a previously published version of a business app](#delete-a-previously-published-version-of-a-business-app)

***

## Set permissions for business apps

The permissions for business apps appear under the App Platform section of the permissions settings (see Figure 2).

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FqnMatdJsHcVu3LHH3CmT%2Fappdev_businessapps_businessapppermissions.png?alt=media&amp;token=6b38608b-8338-4580-8ac8-b7c8dc57ae9d" alt="The user finds the permission controls for business apps in the App Platform settings." width="563"><figcaption><p><strong>Figure 2:</strong> Permissions for business apps.</p></figcaption></figure></div>

To control access to business apps, set the Business App Developer permission. See the following table for details.

| Permission             | Controls access to | None                                | View                                                                                                                                      | Create/Edit                                                   | Delete/All                                                                                          |
| ---------------------- | ------------------ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Business App Developer | Business apps      | The user can't build business apps. | The user can access any developer's preview version of the business app, authorize their own services, and configure user-level settings. | *There are no separate permissions at the Create/Edit level.* | The user can build and manage business apps and app versions and configure business-level settings. |

{% hint style="info" %}
**Note:** To use KiCode throughout Kizen, you must also enable the AI Business Builder permission. However, if you build business apps with your own connected coding agent, you don't need this permission.
{% endhint %}

For more information on permissions in Kizen, see [Permissions](https://developer.kizen.com/docs/settings-and-administration/permissions.md).&#x20;

***

## Review your business apps

To review your business apps:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab&#x20;

Kizen displays a complete list of your business apps, including unpublished and disabled business apps.

{% hint style="info" %}
**Note:** All your published business apps also appear under the Installed tab of the App Marketplace. This list includes business apps that you published and disabled.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Inspect the details of a business app

To inspect the details of a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Open the app details

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and select **View Details**.

The details appear under the App Details tab of the app's configuration page.

{% hint style="info" %}
**Note:** To get the current version number and the version history of the business app, switch to the Version tab of the app's configuration page. You can also find the version number in the list of business apps.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Create a business app

To create a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Create the app

Do one of the following:

* **To create the business app with KiCode,** select **Create with KiCode** (see Figure 3). Kizen opens a new KiCode session. For more information, see [KiCode](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/develop-apps/work-with-kicode.md).

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2F2EqGmvoLMVJRs3TwwEmZ%2Fappdev_businessapps_createwithkicode.png?alt=media&amp;token=ea4659e9-995b-4b1c-a44b-bb44a917d639" alt="The user selects Create with KiCode to build a business app with KiCode." width="563"><figcaption><p><strong>Figure 3:</strong> Create with KiCode.</p></figcaption></figure></div>

* **To create the business app with an external coding agent,** open the menu of the **Create with KiCode** button, and select **Create with Your AI** (see Figure 4). Kizen displays a modal that contains a ready-made prompt for you to copy and paste into your coding agent. This prompt connects the coding agent to Kizen. After you connect your coding agent, you can use it to build business apps.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Frk7A1XMf8mMg6rTe7ZvW%2Fappdev_businessapps_createwithyourai.png?alt=media&amp;token=30929f29-c018-4ba0-a983-c1eec0d3dc3a" alt="The user selects Create with Your AI to build a business app with their own coding agent." width="378"><figcaption><p><strong>Figure 4:</strong> The Create with KiCode button menu.</p></figcaption></figure></div>

{% hint style="info" %}
**Note:** If you already connected a coding agent to Kizen, you don't need to reconnect it here. Begin building the business app from your coding agent whenever you're ready.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Edit a business app

To edit a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Edit the app

Open the business app's Actions menu, and select **Edit with KiCode**. Kizen opens the previous KiCode session for this app.

{% hint style="info" %}
**Note:** You can also use KiCode to edit a business app that you built from an external coding agent. KiCode opens with an empty chat and an empty Files list, but it populates the list as soon as you start editing.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Publish a business app

To publish a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab&#x20;

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Publish the app

Find the preview version of the business app that you want to promote to the published version, open this app's Actions menu, and select **Publish**.
{% endstep %}

{% step %}

### Confirm

Kizen displays a modal asking if you want to publish the preview. Publishing the preview makes the business app available to everyone in your business. If the preview represents the new version of a previously published business app, this preview version becomes the new published version.

To proceed, select **Publish**.

{% hint style="info" %}
**Note:** If you publish the preview of a disabled business app, the newly published version is also disabled.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Configure a published business app

To configure a published business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Develop tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Open the app's configuration page

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and select **View Details**.
  {% endstep %}

{% step %}

### Configure the app

Do either of the following:

* **To configure the app settings for all users in your business,** switch to the **App Settings** tab.
* **To configure the app settings for your individual Kizen account,** switch to the **User Settings** tab.

{% hint style="info" %}
**Note:** If you don't find the App Settings or User Settings tab on the business app's configuration page, the app doesn't have these settings to configure.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Disable a published business app

Disabling a published business app makes it inaccessible to all team members without deleting it or erasing its configuration.

To disable a published business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Disable the app

Open the business app's Actions menu, and select **Disable**.

{% hint style="info" %}
**Note:** You can't disable business apps in the Preview stage.
{% endhint %}
{% endstep %}

{% step %}

### Confirm

Kizen opens a modal asking you to confirm whether you want to disable the business app. Select **Disable** to proceed.
{% endstep %}
{% endstepper %}

***

## Re-enable a disabled business app

To re-enable a disabled business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Enable the app

Open the business app's Actions menu, and select **Enable**.
{% endstep %}
{% endstepper %}

***

## Switch to a preview version of a business app

From the published version of a business app, you can switch to any current preview version. Switching affects only your own version of the app. The published version remains the one that all team members of the business can access.

To switch to a preview version of a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **App Marketplace**.
{% endstep %}

{% step %}

### Switch to the Develop tab&#x20;

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Switch to the preview version

Expand the list under the published version of the business app to find all the preview versions. Locate the preview that you want, open its Actions menu, and select **Switch to This Version** (see Figure 5).

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FT1iZjwNo5NWabXDbuHLB%2Fappdev_businessapps_restore.png?alt=media&amp;token=676bb708-7838-49ca-a33e-66e427969973" alt="The user opens the Actions menu for a preview business app." width="563"><figcaption><p><strong>Figure 5:</strong> The Actions menu for a preview business app.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## Switch to the published version of a business app

From your current preview version of a business app, you can switch to the published version without abandoning your changes. Switch back to the preview version to resume development.

To switch to the published version of a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **App Marketplace**.
{% endstep %}

{% step %}

### Switch to the Develop tab&#x20;

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Switch to the published version

Expand the list under the preview version of the business app to find the published version of the app. Then open this app's Actions menu, and select **Switch to Published Version** (see Figure 6).

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FkB0AYR2Ll2fcQxKiHkr1%2Fappdev_businessapps_expanded.png?alt=media&amp;token=b2e67dff-7d6b-4b0d-b3d8-9e9566bf6b15" alt="The user opens the Actions menu for a published business app." width="563"><figcaption><p><strong>Figure 6:</strong> The Actions menu for a published business app.</p></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## Delete a preview version of a business app

Deleting a preview version of a business app doesn't affect the published version or any other preview versions of the app, nor does it affect any associated records in Kizen. However, if the preview version is the only version of the app, deleting it removes its business-level and user-level settings as well as its managed secrets.

To delete a preview version of a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **App Marketplace**.
{% endstep %}

{% step %}

### Switch to the Develop tab&#x20;

Kizen displays a complete list of your business apps.
{% endstep %}

{% step %}

### Delete the preview version

Open the business app's Actions menu, and select **Delete Preview**.

{% hint style="info" %}
**Note:** The business app must be in the Preview stage.
{% endhint %}
{% endstep %}

{% step %}

### Confirm

Kizen displays a modal asking if you want to delete the preview. Select **Confirm Delete** to proceed.
{% endstep %}
{% endstepper %}

***

## Delete a previously published version of a business app

To delete a previously published version of a business app:

{% stepper %}
{% step %}

### Go to the App Marketplace

From the global navigation, select **Platform** > **Apps**.
{% endstep %}

{% step %}

### Switch to the Installed tab

Kizen lists the marketplace apps you have installed for your business.
{% endstep %}

{% step %}

### Open the app's configuration page

Do one of the following:

* Select the name of the app.
* Open the app's Actions menu, and choose **View Details**.
  {% endstep %}

{% step %}

### Open the app's version history

Select the Version tab. Kizen displays a list of the previously published versions of the app.
{% endstep %}

{% step %}

### Delete the version

Select the ellipsis icon of the version to delete, and select **Delete Version** from the menu that appears.
{% endstep %}

{% step %}

### Confirm

Kizen displays a modal asking if you want to delete the selected version. Select **Confirm Delete** to proceed.

{% hint style="info" %}
**Note:** Deleting a previously published version of a business app deletes the app but not its records.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## What's next

Continue to [Develop Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/develop-apps.md) to learn how to build Kizen apps.

<details>

<summary>Related Topics</summary>

* [Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development.md)
* [Work with Marketplace Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-marketplace-apps.md)
* [Develop Apps](https://developer.kizen.com/docs/apps-and-integrations/plugin-development/develop-apps.md)

</details>

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developer.kizen.com/docs/apps-and-integrations/plugin-development/work-with-business-apps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
