---
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
- **version**: The app's version info (if specified)
- **authors**: The app's authors (if specified)
- **environment**: The app's environment (if specified)
- **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.

## Query parameters

- `page` integer — Pagination: The page number to return (offset)
- `per_page` integer — Pagination: Number of items to return per page

## Response `200`

Successful Response

- AppConfigOutput[]
  - `id` string, required
  - `display_name` string, nullable, required
  - `description` string, nullable, required
  - `access_groups` string[], required
  - `environment` object
  - `version` string, nullable
  - `authors` string[], nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-06-30** `358e5609409b` — 1 info
  - api operation id `get_apps` removed and replaced with `get_apps_apps__get`
- **2026-02-24** `2ac7baf8418f` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2025-06-14** `87a967423b01` — 7 info
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `per_page`
  - added the non-success response with the status `422`
  - added the optional property `items/authors` to the response with the `200` status
  - …3 more
- **2023-08-15** `6befde16ec1c` — 3 breaking, 3 info
  - response property `items/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/display_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the response property `items/description` became required for the status `200`
  - …2 more
- **2021-12-08** `dae88d8eb1ce` — 1 info
  - endpoint added

[Full 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/358e5609409b/schema)