Skip to main content
GET
/
api
/
v1
/
chatflows
List Agentflows
curl --request GET \
  --url https://api.example.com/api/v1/chatflows
{
  "401": {},
  "403": {},
  "500": {},
  "id": "<string>",
  "name": "<string>",
  "flowData": "<string>",
  "deployed": true,
  "isPublic": true,
  "type": "<string>",
  "category": "<string>",
  "createdDate": {},
  "updatedDate": {},
  "workspaceId": "<string>"
}
Retrieves a list of all agentflows in your workspace. Agentflows are AI agent workflows with specific types and configurations.

Query Parameters

type
string
Filter by flow type. Use AGENTFLOW to list only agentflows.

Response

id
string
Unique identifier for the agentflow
name
string
Name of the agentflow
flowData
string
JSON string containing the flow configuration and node data
deployed
boolean
Whether the agentflow is currently deployed
isPublic
boolean
Whether the agentflow is publicly accessible
type
string
Flow type (CHATFLOW, AGENTFLOW, MULTIAGENT, or ASSISTANT)
category
string
Category classification for the agentflow
createdDate
timestamp
Timestamp when the agentflow was created
updatedDate
timestamp
Timestamp when the agentflow was last updated
workspaceId
string
ID of the workspace containing this agentflow

Example Request

curl -X GET \
  'https://your-flowise-instance.com/api/v1/chatflows?type=AGENTFLOW' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

[
  {
    "id": "abc123-def456-ghi789",
    "name": "Customer Support Agent",
    "flowData": "{\"nodes\":[...],\"edges\":[...]}",
    "deployed": true,
    "isPublic": false,
    "type": "AGENTFLOW",
    "category": "Customer Service",
    "createdDate": "2024-01-15T10:30:00Z",
    "updatedDate": "2024-01-20T14:45:00Z",
    "workspaceId": "workspace-123"
  }
]

Error Responses

401
error
Unauthorized - Invalid or missing API key
403
error
Forbidden - Insufficient permissions to view agentflows
500
error
Internal Server Error - Server encountered an error processing the request

Build docs developers (and LLMs) love