---
title: "Install app"
method: POST
path: "/devices/{deviceId}/apps"
tags: ["Tools/Apps"]
---

# Install app

`POST /devices/{deviceId}/apps`

Requests an app install on the device. The request body must supply exactly one of an Android packageName or an iOS bundleId; protected packages are rejected. background (default false) selects the response contract: false installs inline and returns the outcome directly (200 on success, an error status on failure); true accepts the request and runs the download + install in the background, returning 202 immediately — poll list-app-installs for the backend's view of that attempt's status. Refuses with 409 once 2 other installs are already running on the device, in either mode; a repeat request for an app that already has an install running is also refused with 409 rather than superseding it — retry once that attempt reaches a terminal state.

## Path parameters

- `deviceId` string, required

## Headers

- `X-Device-Display-ID` integer

## Request body

- union
  - object
    - `background` boolean — true: return 202 immediately and install in the background (poll list-app-installs). false/omitted: install inline and return the outcome directly (200 on success, an error status on failure).
    - `bundleId` string, required — iOS bundle identifier (e.g. com.example.app)
    - `packageName` string — Android package name (e.g. com.example.app)
  - object
    - `background` boolean — true: return 202 immediately and install in the background (poll list-app-installs). false/omitted: install inline and return the outcome directly (200 on success, an error status on failure).
    - `packageName` string, required — Android package name (e.g. com.example.app)
    - `bundleId` string — iOS bundle identifier (e.g. com.example.app)

## Response `200`

Install finished synchronously (background omitted or false).

## Other responses

- `202` — Accepted

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)