---
title: "Update one app by app identifier."
method: PUT
path: "/app/{appId}"
tags: ["apps"]
---

# Update one app by app identifier.

`PUT /app/{appId}`

## Request

- Base URL: `https://api.capgo.app`
- URL: `https://api.capgo.app/app/{appId}`
- Auth: API key in header `x-api-key`

Update app settings such as name or configuration for a single `appId`. Does not upload a new live-update bundle.

## Path parameters

- `appId` string, required

## Request body

- AppUpdate
  - `name` string
  - `icon` string, uri
  - `retention` integer

## Response `200`

Updated application.

- AppEnvelope
  - `data` App, required
    - `app_id` string, required
    - `name` string, nullable
    - `owner_org` string
    - `default_upload_channel` string
    - `icon_url` string, uri, nullable
    - `last_version` string, nullable
    - `retention` integer
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable

## Other responses

- `400`: The request body or query parameters were invalid.
- `401`: The API key is missing, invalid, or expired.
- `403`: The API key is valid but lacks the required scope or org access.
- `429`: Too many requests. Back off and retry later.
- `500`: Unexpected Capgo server error.

---

[API](https://skmtc.dev/capgo/apis/capgo-public-api.md) · [All operations](https://skmtc.dev/capgo/apis/capgo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capgo/apis/capgo-public-api/revisions/8496acb7a95b?raw)