---
title: "Introduction to Managing Apps"
slug: "introduction-to-managing-apps"
updated: 2026-10-05T17:12:53Z
published: 2026-10-05T17:12:53Z
canonical: "developer.rocket.chat/introduction-to-managing-apps"
---

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

# Introduction to Managing Apps

Rocket.Chat apps extend a workspace with integrations and features, installed from the marketplace or uploaded as private apps. The Manage Apps endpoints let administrators browse the marketplace, install and uninstall apps, and read app logs programmatically; the API counterpart of the **Marketplace** admin area.

## The app object

App endpoints return app objects. A trimmed example from [List Installed Apps](https://developer.rocket.chat/apidocs/list-installed-apps-1):

```json
{
  "apps": [
    {
      "id": "346b465f-3087-4596-ad7f-b0885540451c",
      "name": "Google Meet",
      "nameSlug": "google-meet",
      "version": "1.0.4",
      "requiredApiVersion": "^1.33.0",
      "description": "Google Meet Conference Calls Provider",
      "author": {
        "name": "Rocket.Chat Technologies Corp.",
        "homepage": "https://github.com/RocketChat/Rocket.Chat"
      }
    }
  ],
  "success": true
}
```

Fields you use most often:

- `id`: The app ID. Pass it in the path when fetching details, uninstalling, or reading an app's logs.
- `version` and `requiredApiVersion`: The installed app version and the Apps-Engine API range it needs.
- `nameSlug`: The URL-friendly identifier used in the marketplace.

## Common workflows

**Install and manage an app**

1. [List the marketplace apps](https://developer.rocket.chat/apidocs/list-marketplace-apps-1) or [browse app categories](https://developer.rocket.chat/apidocs/list-app-categories-1) to find an app, or [install a private app](https://developer.rocket.chat/apidocs/install-private-apps-1) from its package.
2. [List the installed apps](https://developer.rocket.chat/apidocs/list-installed-apps-1) and [fetch an app's details](https://developer.rocket.chat/apidocs/fetch-details-of-an-app-1) by its `id`.
3. [Uninstall the app](https://developer.rocket.chat/apidocs/uninstall-an-app-1) when it is no longer needed.

**Troubleshoot an app**

1. [Get the app's logs](https://developer.rocket.chat/apidocs/get-an-app-s-logs-1), or [all apps' logs](https://developer.rocket.chat/apidocs/get-all-apps-logs-1), to see what the app executed and any errors.
2. [Get the apps count](https://developer.rocket.chat/apidocs/get-apps-count-1) to check installed and enabled totals against your plan's limits.
3. If a user needs an app you have not installed, they can [generate an app request form](https://developer.rocket.chat/apidocs/generate-external-app-request-form-1) for admins to review.

## Conventions

- These endpoints live under `/api/apps` rather than `/api/v1` . Note the different base path.
- Managing apps requires the `manage-apps` admin permission. Each endpoint page lists its requirements.
- Apps run on the Apps-Engine: an app only installs if the workspace's engine satisfies the app's `requiredApiVersion`. Private app uploads can be restricted by the workspace's plan and settings.
- For the admin UI equivalent, see the [Rocket.Chat Marketplace](https://docs.rocket.chat/docs/rocketchat-marketplace) guide.