---
title: "List Apps"
method: GET
path: "/api/app"
tags: ["Workflow App API"]
---

# List Apps

`GET /api/app`

## Request

- The document declares no server URL.
- Auth: none declared

## Query parameters

- `name` string, nullable
- `users` string[], nullable
- `all_users` boolean
- `offset` integer
- `limit` integer
- `order` 'ASC' | 'DESC': Represents the list order for the database.

## Headers

- `x-osmo-user` string, nullable

## Response `200`

Successful Response

- SrcServiceCoreAppObjectsListResponse
  - `apps` SrcServiceCoreAppObjectsListEntry[], required
    - `uuid` string, required
    - `name` string, required
    - `description` string, required
    - `created_date` string, date-time, required
    - `owner` string, required
    - `latest_version` integer, required
  - `more_entries` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 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
- **2026-04-08** `a8157dc3279d`: 2 breaking, 9 info
  - the `query` request parameter `order` was restricted to a list of enum values
  - the `apps/items/latest_version` response's property type changed from `string` to `integer` for status `200`
  - added the new enum value `ASC` to the `query` request parameter `order`
  - added the new enum value `DESC` to the `query` request parameter `order`
  - …7 more
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 2 info
  - the response's body type changed from `string` to `object` for status `200`
  - added the required property `apps` to the response with the `200` status
  - added the required property `more_entries` to the response with the `200` status

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/app/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)