---
title: "Install a catalog app (control key)"
method: POST
path: "/devices/{name}/apps"
tags: ["Apps"]
---

# Install a catalog app (control key)

`POST /devices/{name}/apps`

## Request

- Base URL: `https://api.clousd.com/v1`
- URL: `https://api.clousd.com/v1/devices/{name}/apps`
- Auth: HTTP bearer

## Request body

- object
  - `package` string, required
  - `version` string

## Response `202`

Install job started

- object
  - `ok` boolean
  - `job` Job
    - `id` string
    - `kind` string
    - `phone` string
    - `state` 'running' | 'done' | 'failed'
    - `started` string, date-time
    - `done` string, date-time
    - `output` string
  - `package` string
  - `version` string

## Other responses

- `404`: Error

---

[API](https://skmtc.dev/clousd/apis/clousd-api.md) · [All operations](https://skmtc.dev/clousd/apis/clousd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clousd/apis/clousd-api/revisions/0291ffd26ae3?raw)