> ## Documentation Index
> Fetch the complete documentation index at: https://docs.penbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Flows

> Previous version of List Form Templates. Retrieve available flows.

<Warning>
  Previous API version. Use [`GET /form_templates`](/api-reference/flows/list-flows) for new integrations. This route still works but is deprecated.
</Warning>

Retrieve all active flows (now called form templates) available in the authorized workspaces.

```text theme={null}
GET https://connect.penbox.io/v1/flows
```

## Query Parameters

| Parameter  | Type    | Description                                                |
| ---------- | ------- | ---------------------------------------------------------- |
| `archived` | boolean | When `true`, returns archived flows instead of active ones |

## Response

<Warning>
  Unlike the current `GET /form_templates` endpoint, this route returns a **bare JSON array** with no pagination `meta` envelope.
</Warning>

```json theme={null}
[
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "created_at": "2024-01-15T10:30:00Z",
    "slug": "client-onboarding",
    "name": "Client Onboarding",
    "archived_at": null,
    "enabled": true,
    "workspace": { "id": "...", "slug": "acme-corp" }
  }
]
```

<Warning>
  Flow slugs can be reused across different workspaces. Always combine the flow slug with the workspace slug when storing or referencing them in your system.
</Warning>

## Example

```bash cURL theme={null}
curl 'https://connect.penbox.io/v1/flows' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
```

## Response Codes

| Code  | Description                      |
| ----- | -------------------------------- |
| `200` | Success — returns array of flows |
| `401` | Unauthorized                     |
| `403` | Forbidden                        |
| `429` | Too Many Requests                |
| `500` | Server Error                     |