---
title: "Get all visible MIRO apps"
method: GET
path: "/apps/"
tags: ["apps"]
---

# Get all visible MIRO apps

`GET /apps/`

Get all apps registered for one of your user groups and their metadata.

An app object contains the following fields:

- **id**: The unique identifier of the app
- **display_name**: The name of the app as it appears in the library
- **description**: The description of the app as it appears in the library
- **access_groups**: The user groups that can see this app. If no user groups are assigned (empty array), anyone with access to the MIRO Server instance can see the app. Displays only subset of user groups of which the logged in user is a member.

## Response `200`

Successful Response

- AppConfig[]
  - `id` string
  - `display_name` string
  - `description` string
  - `access_groups` string[], required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `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` — 1 breaking, 1 warning, 2 info
  - removed the required property `items/accessGroups` from the response with the `200` status
  - removed the optional property `items/displayName` from the response with the `200` status
  - added the optional property `items/display_name` to the response with the `200` status
  - added the required property `items/access_groups` to the response with the `200` status

[Change history](https://skmtc.dev/gams-dev/apis/miro-server-api/changes/apps/get.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/5366dfd18e83/schema)