---
title: "patchInstallation"
method: PATCH
path: "/v1/app/{appId}"
tags: ["App Installation"]
---

# patchInstallation

`PATCH /v1/app/{appId}`

Patch an installed app by its ID.

## Path parameters

- `appId` string, required

## Request body

- object
  - `version` string — Version of the app to update to
  - `option_values` OptionsRef[] — Configuration values for the app components
    - `component_id` string, required — ID of the component these values are for
    - `options` Option[], required
      - `key` string, required — Key matching a config_option from the component
      - `value` union, required — The configured value for this option
        - string
        - boolean
        - number
  - `_manifest` string[] — Manifest ID used to create/update the entity

## Response `204`

App installation patched successfully.

## Other responses

- `404` — App not found.

## Changes

- **2025-06-19** `03b93188c6d4` — 1 info
  - added the new optional request property `_manifest`
- **2025-06-18** `d6e3c1e0a11b` — 1 breaking
  - the `option_values/items/options/items/value` request property type/format changed from `string`/`` to `string, boolean, number`/``
- **2025-05-22** `2ab2aaf08d93` — 1 info
  - added the new optional request property `version`
- **2025-04-30** `96130e8314f3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/epilot/apis/app-api/changes/v1/app/:appId/patch.md)

---

[API](https://skmtc.dev/epilot/apis/app-api.md) · [All operations](https://skmtc.dev/epilot/apis/app-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/app-api/revisions/03b93188c6d4/schema)