> ## Documentation Index
> Fetch the complete documentation index at: https://assembly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# App Installs

> An instance of an app added to a workspace, covering core, marketplace, custom, embed, link, and manual app types.

This resource represents an instance of an app added to a workspace. By calling [List App Installs](/docs/api-reference/resources/app-installs), you can retrieve all apps in a workspace.

Apps in Assembly can be of a few different types:

* **Core apps** are the apps that come pre-built into Assembly: Messages, Billing, Files, Contracts, Forms, Help Desk.
* **Marketplace Apps** are [public apps available to all customers](https://docs.assembly.com/docs/marketplace-apps-overview) via the Assembly App Store. They are embedded into Assembly but are more sophisticated than **Embeds** in that they utilize the Assembly API.
* **Custom Apps** are [private apps installed into a single workspace](https://docs.assembly.com/docs/custom-apps-overview), that utilize the Assembly API.
* **Embeds** are websites that are added into Assembly as iframe embeds that do not use the Assembly API.
* **Links** are websites that are added into Assembly, that direct clients to an external URL. Links are typically used for applications that block iframe embedding.
* **Manual** setup apps allow Service Businesses to specify different content for different clients. For each specified client, company, or group of clients, the app content can be an embed or a link. Each connection of a manual app install to a client, company, or group of clients is represented by the [App Connections](/docs/api-reference/resources/app-connections) resource.

## Properties

**id** `string`
The unique ID of this app install.

**appId** `string`
The source app for this app install. Core, marketplace, and custom app installs all have a backing app; embeds, links, and manual app installs do not, and return an empty string. This is the same `appId` that [Notifications](/docs/api-reference/resources/notifications) carry, so you can group notifications by app and join them back to the install that produced them.

For core and marketplace apps you can use this table to identify which app is which (since a Service Business can rename the `displayName` of the app, e.g. Chat instead of Messages):

| App Name                              | App ID                                 |
| :------------------------------------ | :------------------------------------- |
| Messages \[core]                      | `38323633-6465-6132-3730-383065323230` |
| Billing \[core]                       | `64346438-6461-6431-6565-366361383434` |
| Files \[core]                         | `33343966-3136-6166-6561-343739303432` |
| Contracts \[core]                     | `34633033-3365-6561-6332-386434316430` |
| Forms \[core]                         | `66666663-3861-6633-3830-323337613065` |
| Helpdesk \[core]                      | `30643961-3563-3361-3035-396231663435` |
| Client Home \[marketplace]            | `a6e3a6f3-2f2a-4c79-b77c-9508da6e80dc` |
| Profile Manager \[marketplace]        | `059a15eb-031e-4fd2-b600-1429174b85f2` |
| Message Auto-responder \[marketplace] | `96e9122d-9e84-483f-a79b-4363b8986b17` |
| Message Exporter \[marketplace]       | `5b58089c-1e81-439c-b511-01e3e599c23d` |
| Tasks \[marketplace]                  | `0e1dff29-1ce3-40ac-b58d-264097f6b319` |

<br />

**displayName** `string`
The label for the app install within the workspace. This is the label that clients and internal users see on the left navbar when they click on the app.

**type** `string`
The type of app that has been installed (one of: `core`, `custom`, `marketplace`, `embed`, `link`, `manual`)

**object** `string`
The object type for this resource

<br />

```json Example App Install Object theme={null}
  {
    "appId": "38323633-6465-6132-3730-383065323230",
    "displayName": "Messages",
    "id": "62346132-6462-3736-3733-366430333631",
    "type": "core",
    "object": "appInstall"
  }
```

```json Example App Install Object 2 theme={null}
  {
    "appId": "a6e3a6f3-2f2a-4c79-b77c-9508da6e80dc",
    "displayName": "Home",
    "id": "15dadd33-1e63-4e59-9752-d5e916cfae59",
    "type": "marketplace",
    "object": "appInstall"
  }
```

```json Example App Install Object 3 theme={null}
  {
    "appId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "displayName": "Onboarding Tracker",
    "id": "8b1f0c47-6d3a-4a21-9e55-2c7b1a9f4d80",
    "type": "custom",
    "object": "appInstall"
  }
```

```json Example App Install Object 4 theme={null}
  {
    "appId": "",
    "displayName": "Schedule with me",
    "id": "45729d42-f825-491e-aec4-a58a5a4f74fe",
    "type": "link",
    "object": "appInstall"
  }
```