Previous API version. Use GET /form_templates for new integrations. This route still works but is deprecated.
Retrieve all active flows (now called form templates) available in the authorized workspaces.
GET https://connect.penbox.io/v1/flows
Query Parameters
| Parameter | Type | Description |
|---|
archived | boolean | When true, returns archived flows instead of active ones |
Response
Unlike the current GET /form_templates endpoint, this route returns a bare JSON array with no pagination meta envelope.
[
{
"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" }
}
]
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.
Example
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 |