---
title: "list resources"
method: GET
path: "/w/{workspace}/resources/list"
tags: ["resource"]
---

# list resources

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

## Path parameters

- `workspace` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `resource_type` string
- `resource_type_exclude` string
- `path_start` string
- `path` string
- `description` string
- `value` string
- `broad_filter` string
- `label` string
- `include_draft_only` boolean

## Response `200`

resource list

- ListableResource[]
  - `workspace_id` string
  - `path` string, required
  - `description` string
  - `resource_type` string, required
  - `value` unknown
  - `is_oauth` boolean, required
  - `extra_perms` object
  - `is_expired` boolean
  - `refresh_error` string
  - `is_linked` boolean, required
  - `is_refreshed` boolean, required
  - `account` number
  - `created_by` string
  - `edited_at` string, date-time
  - `labels` string[]
  - `inherited_labels` string[] — Labels inherited from the parent folder, computed at read time. Read-only — edit them on the folder.
  - `ws_specific` boolean
  - `draft_only` boolean — True when this row is a per-user draft with no deployed resource at the same path. Frontend renders a "Draft" badge.
  - `is_draft` boolean — 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.

---

[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/revisions/db0e7e036e34/schema)