Update a workflow
Base URL
https://{kibana_url}
Auth
Partially update an existing workflow. You can update individual fields such as name, description, enabled state, tags, or the YAML definition without providing all fields.
Privileges
workflowsManagement:update
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.
id
string · max length: 255 required
Workflow ID
A required header to protect against CSRF attacks
200
Indicates a successful response
application/json
Thank you for your feedback.
Base URL
https://{kibana_url}
Examples
Update workflow enable
languages
Update workflow full
languages
Request
Console
1 / 2 languages
‹
›
Example request to enable a workflow and update its tags
Show more
1
2
3
4
5
PUT kbn://api/workflows/workflow/{id}
{
"enabled": true,
"tags": ["production"]
}
1
2
3
4
5
6
7
8
9
curl \
-X PUT "${KIBANA_URL}/api/workflows/workflow/{id}" \
-H "Authorization: ApiKey ${API_KEY}" \
-H "kbn-xsrf: true" \
-H "Content-Type: application/json" \
-d '{
"enabled": true,
"tags": ["production"]
}'
Response
Example response returning the updated workflow
Show more
1
2
3
4
5
6
7
8
{
"enabled": false,
"id": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"lastUpdatedAt": "2026-03-23T13:38:59.568Z",
"lastUpdatedBy": "elastic",
"valid": true,
"validationErrors": []
}
Request
Console
1 / 2 languages
‹
›
Example request to update multiple workflow fields
Show more
1
2
3
4
5
6
7
8
9
10
11
PUT kbn:/api/workflows/workflow/ID
{
"description": "Updated workflow description",
"enabled": true,
"name": "Updated example",
"tags": [
"example",
"updated"
],
"yaml": "name: Updated example\nenabled: true\ndescription: Updated workflow description\ntriggers:\n - type: manual\ninputs:\n - name: message\n type: string\n default: \u0022hello world\u0022\nsteps:\n - name: hello_world_step\n type: console\n with:\n message: \u0022{{ inputs.message }}\u0022\n"
}
Generated from the API spec
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
curl \
-X PUT "${KIBANA_URL}/api/workflows/workflow/${ID}" \
-H "Authorization: ApiKey ${API_KEY}" \
-H "kbn-xsrf: true" \
-H "Content-Type: application/json" \
-d '{
"description": "Updated workflow description",
"enabled": true,
"name": "Updated example",
"tags": [
"example",
"updated"
],
"yaml": "name: Updated example\nenabled: true\ndescription: Updated workflow description\ntriggers:\n - type: manual\ninputs:\n - name: message\n type: string\n default: \u0022hello world\u0022\nsteps:\n - name: hello_world_step\n type: console\n with:\n message: \u0022{{ inputs.message }}\u0022\n"
}'
Generated from the API spec
Response
Example response returning the updated workflow
Show more
1
2
3
4
5
6
7
8
{
"enabled": false,
"id": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"lastUpdatedAt": "2026-03-23T13:38:59.568Z",
"lastUpdatedBy": "elastic",
"valid": true,
"validationErrors": []
}