Get workflows
Base URL
https://{kibana_url}
GET
/api/workflows
GET
/s/{space_id} /api/workflows
Auth
Stack
9.4+
The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.
Availability
Generally available since 9.4
This functionality is generally available and ready for production usage.
Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.
This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.
Retrieve a paginated list of workflows with optional filtering.
Privileges
workflowsManagement:read. Extended privileges (optional, expand functionality when granted): workflowsManagement:managed:read, workflowsManagement:readExecution, workflowsManagement:managed:readExecution
Expand all
space_id
string optional
An identifier for the space. If space_id is not provided in the URL, the default space is used. Refer to Spaces for more information.
query
string · max length: 4096
Free-text search query.
size
number · min: 1 · max: 10000
Number of results per page.
page
number · min: 1
Page number.
enabled
boolean [] · max items: 2
Filter by enabled state.
createdBy
string [] · max items: 1000
Filter by creator.
tags
string [] · max items: 1000
Filter by tags.
managed
enum
Filter by managed status. Defaults to "unmanaged".
Values:
all
managed
unmanaged
visibilityContext
string [] · max items: 1000
When managed workflows are included, only return managed workflows visible in these contexts.
sortField
enum
Field to sort by.
Values:
name
enabled
sortOrder
enum
Sort direction.
Values:
asc
desc
200
Indicates a successful response
application/json
Thank you for your feedback.
Base URL
https://{kibana_url}
Examples
Request
Console
1 / 2 languages
‹
›
1
GET kbn://api/workflows?size=20&page=1&sortField=name&sortOrder=asc
1
2
3
curl \
-X GET "${KIBANA_URL}/api/workflows?size=20&page=1&sortField=name&sortOrder=asc" \
-H "Authorization: ApiKey ${API_KEY}"
Response
Example response returning a paginated list of workflows
Show more
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
{
"page": 1,
"results": [
{
"createdAt": "2025-11-20T10:30:00.000Z",
"definition": {
"description": "This is a workflow example",
"enabled": true,
"inputs": [
{
"default": "hello world",
"name": "message",
"type": "string"
}
],
"name": "Example definition",
"steps": [
{
"name": "hello_world_step",
"type": "console",
"with": {
"message": "{{ inputs.message }}"
}
}
],
"triggers": [
{
"type": "manual"
}
]
},
"description": "This is a workflow example",
"enabled": true,
"history": [
{
"duration": 5000,
"finishedAt": "2025-11-20T12:00:05.000Z",
"id": "exec-001",
"startedAt": "2025-11-20T12:00:00.000Z",
"status": "completed",
"workflowId": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"workflowName": "Example definition"
}
],
"id": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Example definition",
"tags": [
"example"
],
"valid": true
}
],
"size": 20,
"total": 1
}