---
title: "Update an existing MIRO app"
method: PUT
path: "/apps/{app_id}"
tags: ["apps"]
---

# Update an existing MIRO app

`PUT /apps/{app_id}`

Update a MIRO app (requires write permissions on namespace).

The app as well as its metadata will be overwritten. This means that you should specify all parameters.
For example, if you do not specify `access_groups`, no access groups will be assigned to the app.
This will result in it being visible to everyone.

## Path parameters

- `app_id` string, required — The ID of the app to update.

## Response `200`

App successfully updated

- unknown

## Other responses

- `400` — You cannot update an app with this ID
- `401` — Unauthorized
- `403` — Forbidden
- `404` — An app with this ID does not exist
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2021-12-08** `dae88d8eb1ce` — 1 info
  - endpoint added
- **2021-12-08** `ea0ae3dcf969` — 1 breaking
  - api path removed without deprecation
- **2021-11-22** `f1a3e6959567` — 3 warning
  - for the `path` request parameter `app_id`, the maxLength was set to `60`
  - the `description` request property's maxLength was set to `200`
  - the `display_name` request property's maxLength was set to `40`

[Change history](https://skmtc.dev/gams-dev/apis/miro-server-api/changes/apps/:app_id/put.md)

---

[API](https://skmtc.dev/gams-dev/apis/miro-server-api.md) · [All operations](https://skmtc.dev/gams-dev/apis/miro-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gams-dev/miro-server-api/revisions/331d92523899/schema)