---
title: "List CloudFlows"
method: GET
path: "/cloudflow/v1/flows"
tags: ["CloudFlow"]
---

# List CloudFlows

`GET /cloudflow/v1/flows`

Returns a cursor-paginated list of CloudFlows.

## Query parameters

- `maxResults` integer
- `pageToken` string

## Response `200`

Paginated list of CloudFlows.

- CloudflowListResponse
  - `items` Cloudflow[], required — List of CloudFlows.
    - `id` string, required
    - `name` string, required
    - `description` string
    - `instructions` string, nullable
    - `published` boolean, required
    - `triggerType` string, nullable
    - `createTime` string, date-time, required
    - `updateTime` string, date-time, nullable
    - `lastExecutedTime` string, date-time, nullable
    - `lastExecutionStatus` 'pending' | 'running' | 'complete' | 'pending-approval' | 'failed' | 'sleeping' | 'stopped', nullable
    - `nextRun` string, date-time, nullable — Next scheduled execution time. `null` when the CloudFlow has no active schedule.
  - `pageToken` string, nullable — Opaque cursor for the next page. `null` when there are no more CloudFlows.
  - `rowCount` integer, nullable — Always `null`. Row count is not computed for this endpoint.

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.
- `500` — Internal Server Error - Something went wrong with the DoiT API server.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)