Update a managed workflow

Base URL: https://{kibana_url}

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

Refer to Spaces for more information.

Partially update an existing managed workflow. This elevated route can update fields beyond the enabled state.

Required authorization

Authentication

Path parameters

Header parameters

Request body

Response

200

Indicates a successful response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

PUT kbn://api/workflows/managed/workflow/{id}
{
  "name": "Updated managed workflow",
  "enabled": true,
  "tags": ["managed", "updated"]
}

curl Shell

curl \
  -X PUT "${KIBANA_URL}/api/workflows/managed/workflow/{id}" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated managed workflow",
    "enabled": true,
    "tags": ["managed", "updated"]
  }'

Request Console 1 / 2 languages

Example request to update a managed workflow

Console Kibana Dev Tools

PUT kbn:/api/workflows/managed/workflow/ID
{
  "description": "Updated managed workflow description",
  "enabled": true,
  "name": "Updated managed workflow",
  "tags": [
    "managed",
    "updated"
  ],
  "yaml": "name: Updated managed workflow\nenabled: true\ndescription: Updated managed workflow description\ntriggers:\n  - type: manual\nsteps:\n  - name: hello_world_step\n    type: console\n    with:\n      message: \u0022hello world\u0022\n"
}

Generated from the API spec

curl Shell

curl \
  -X PUT "${KIBANA_URL}/api/workflows/managed/workflow/${ID}" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "kbn-xsrf: true" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated managed workflow description",
    "enabled": true,
    "name": "Updated managed workflow",
    "tags": [
      "managed",
      "updated"
    ],
    "yaml": "name: Updated managed workflow\nenabled: true\ndescription: Updated managed workflow description\ntriggers:\n  - type: manual\nsteps:\n  - name: hello_world_step\n    type: console\n    with:\n      message: \u0022hello world\u0022\n"
  }'

Generated from the API spec

Response

Example response returning the updated managed workflow

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

Required authorization

Authentication

Path parameters

Header parameters

Request body { }

Response

Request body