Update a workflow

Server: https://{kibana_url}

PUT /api/workflows/workflow/{id}
PUT /s/{space_id}/api/workflows/workflow/{id}

Refer to Spaces for more information.

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.

[Required authorization] Route required privileges: workflowsManagement:update.

Path Parameters

id string required: Workflow ID

Request

Response

200

Indicates a successful response

application/json

Examples

Example request to enable a workflow and update its tags

Request Console 1 / 2 languages

Console Kibana Dev Tools

PUT kbn://api/workflows/workflow/{id}
{
  "enabled": true,
  "tags": ["production"]
}

curl Shell

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

{
  "enabled": false,
  "id": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "lastUpdatedAt": "2026-03-23T13:38:59.568Z",
  "lastUpdatedBy": "elastic",
  "valid": true,
  "validationErrors": []
}

Example request to update multiple workflow fields

Request Console 1 / 2 languages

Console Kibana Dev Tools

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"
}

curl Shell

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"
}'

Response

{
  "enabled": false,
  "id": "workflow-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "lastUpdatedAt": "2026-03-23T13:38:59.568Z",
  "lastUpdatedBy": "elastic",
  "valid": true,
  "validationErrors": []
}

Path Parameters

Request { description , enabled , name , tags , yaml , }

Response

Request