v106

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-03812347972.4 KB

app

list all apps

get/w/{workspace}/apps/list

Path parameters

workspacestring required

Query parameters

pageinteger

which page to return (start at 1, default 1)

per_pageinteger

number of items to return for a given page (default 30, max 100)

order_descboolean

order by desc order (default true)

created_bystring

filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')

path_startstring

mask to filter matching starting path

path_exactstring

mask to filter exact matching path

starred_onlyboolean

(default false) show only the starred items

include_draft_onlyboolean

(default false) include items that have no deployed version

with_deployment_msgboolean

(default false) include deployment message

labelstring

Filter by label

Response

All apps

idinteger required

workspace_idstring required

pathstring required

summarystring required

versioninteger required

extra_permsobject required

starredboolean

edited_atstring date-time required

execution_mode'viewer' | 'publisher' | 'anonymous' required

raw_appboolean

labelsstring[]

is_draftboolean

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_pathstring

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.

inherited_labelsstring[]

Labels inherited from the parent folder, computed at read time. Read-only — edit them on the folder.