---
title: "list all apps"
method: GET
path: "/w/{workspace}/apps/list"
tags: ["app"]
---

# list all apps

`GET /w/{workspace}/apps/list`

## Path parameters

- `workspace` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `order_desc` boolean
- `created_by` string
- `path_start` string
- `path_exact` string
- `starred_only` boolean
- `include_draft_only` boolean
- `with_deployment_msg` boolean
- `label` string

## Response `200`

All apps

- ListableApp[]
  - `id` integer, required
  - `workspace_id` string, required
  - `path` string, required
  - `summary` string, required
  - `version` integer, required
  - `extra_perms` object, required
  - `starred` boolean
  - `edited_at` string, date-time, required
  - `execution_mode` 'viewer' | 'publisher' | 'anonymous', required
  - `raw_app` boolean
  - `labels` string[]
  - `is_draft` boolean — True when the authed user has a draft for this app — either no deployed row exists at this path (draft-only) or the user has saved a per-user draft on top of the deployed row.
  - `draft_path` string — User-typed path the editor has staged but not yet deployed. Sourced from the draft JSON's `draft_path` field (the editor only writes it when the typed path differs from the deployed one). Lets the home list render the meaningful name instead of the autogenerated `u/{user}/draft_{uuid}` URL path. Omitted when unchanged.
  - `draft_users` object[] — Workspace users (including the authed user, and the legacy NULL-email row if any) who have a per-user draft at this path. Drives the home page's user-avatar circles inside the Draft badge. Omitted when no drafts exist.
    - `username` string, nullable
  - `inherited_labels` string[] — Labels inherited from the parent folder, computed at read time. Read-only — edit them on the folder.

---

[API](https://skmtc.net/windmill/apis/windmill-api.md) · [All operations](https://skmtc.net/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill/windmill-api/versions/155a35b3caff/schema)