# List workflows

> The workflows and apps the member can access, or a relevance-ranked subset for a query.

Source: https://docs.generalinput.com/api/workflows/list



<Endpoint method="GET" path="/v1/workflows" />

<Access scope="workflows:manage" />

## Query parameters [#query-parameters]

| Name | Type   | Notes                                                                     |
| ---- | ------ | ------------------------------------------------------------------------- |
| `q`  | string | Optional. Hybrid search over names and descriptions; ranked when present. |

## Response [#response]

```json
{
  "workflows": [
    {
      "id": "wf_01HX…",
      "name": "Daily Digest",
      "workflowType": "code",
      "isEnabled": true,
      "isValid": true,
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}
```

| Field          | Type    | Notes                                                                  |
| -------------- | ------- | ---------------------------------------------------------------------- |
| `workflowType` | string  | `code`, `agent`, or `app`.                                             |
| `isEnabled`    | boolean | Whether triggers fire. Test runs work either way.                      |
| `isValid`      | boolean | The last publish passed validation. For an app, the last build passed. |