v106

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

list resources

get/w/{workspace}/resources/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)

resource_typestring

resource_types to list from, separated by ',',

resource_type_excludestring

resource_types to not list from, separated by ',',

path_startstring

filter resources by path prefix

pathstring

exact path match filter

descriptionstring

pattern match filter for description field (case-insensitive)

valuestring

JSONB subset match filter using base64 encoded JSON

broad_filterstring

broad search across multiple fields (case-insensitive substring match)

labelstring

Filter by label

include_draft_onlyboolean

When true, append per-user draft resources whose path has no deployed resource. Synthesized rows carry draft_only: true.

Response

resource list

workspace_idstring
pathstring required
descriptionstring
resource_typestring required
{"stackTrail":"components:schemas:ListableResource:properties:value","oasType":"schema","type":"unknown"}
is_oauthboolean required
extra_permsobject
is_expiredboolean
refresh_errorstring
is_linkedboolean required
is_refreshedboolean required
accountnumber
created_bystring
edited_atstring date-time
labelsstring[]
inherited_labelsstring[]

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

ws_specificboolean
draft_onlyboolean

True when this row is a per-user draft with no deployed resource at the same path. Frontend renders a "Draft" badge.

is_draftboolean

True when the authed user has a per-user draft at this path (over a deployed row or a synthesized draft-only row). Frontend appends a * to the displayed name.