Endpoint
Authentication
Requires an API key withflows:read scope.
Request
No request body required.Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit | number | Maximum flows to return (default: 50, max: 100) |
offset | number | Number of flows to skip for pagination |
Response
Success (200 OK)
Response Fields
| Field | Type | Description |
|---|---|---|
flows | array | List of flow objects |
flows[].id | string | Unique flow identifier (used in other endpoints) |
flows[].name | string | Human-readable flow name |
flows[].description | string | Flow description |
flows[].version | string | Current version (semver) |
flows[].createdAt | string | ISO 8601 creation timestamp |
flows[].updatedAt | string | ISO 8601 last update timestamp |
total | number | Total number of flows |
limit | number | Limit used in this request |
offset | number | Offset used in this request |
Examples
cURL
TypeScript
With Pagination
Errors
| Status | Code | Description |
|---|---|---|
| 401 | UNAUTHORIZED | Missing or invalid API key |
| 403 | FORBIDDEN | API key missing flows:read scope |
| 429 | RATE_LIMITED | Rate limit exceeded |