> ## Documentation Index > Fetch the complete documentation index at: https://docs.kaizenautomation.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a workflow > Updates workflow fields like name and authentication requirement ## OpenAPI ````yaml post /workflows/update openapi: 3.1.0 info: title: Kaizen API version: 1.0.0 description: API for the Kaizen Automation Platform servers: - url: https://api.kaizenautomation.com description: Production server security: [] paths: /workflows/update: post: tags: - Workflows summary: Update a workflow description: Updates workflow fields like name and authentication requirement requestBody: content: application/json: schema: type: object properties: workflowId: type: string description: ID of the workflow to update name: type: string description: New name for the workflow example: Updated Workflow Name isAuthenticationRequired: type: boolean description: Whether authentication is required for this workflow example: false autoSaveEnabled: type: boolean description: Whether auto-save is enabled for this workflow example: true timeoutMs: type: - integer - 'null' exclusiveMinimum: 0 description: Timeout in milliseconds for workflow execution example: 3600000 shouldPauseOnError: type: boolean description: Whether to pause workflow execution on error example: false shouldSelfHeal: type: boolean description: >- Whether to automatically clean up cache when workflow execution fails example: true shouldSaveResultFile: type: boolean description: Whether to save result files for this workflow example: false model: oneOf: - type: string enum: - gpt-4.1-mini-2025-04-14 - gpt-4.1-2025-04-14 - gpt-5.1-2025-11-13 - gpt-5.4 - gpt-5.4-mini - gpt-5.4-nano - type: string enum: - gemini-2.5-computer-use-preview-10-2025 - gemini-3.1-pro-preview - gemini-3.1-flash-lite - gemini-3.5-flash - type: string enum: - claude-haiku-4-5 - claude-sonnet-4-5 - claude-sonnet-4-6 - claude-opus-4-6 description: The LLM model to use for this workflow example: gpt-4.1-2025-04-14 webhooks: type: array items: type: object properties: id: type: string description: >- Workflow webhook URL external ID. Required for updates, omitted for new webhooks. url: type: string format: uri description: Webhook URL required: - url description: >- List of webhooks to receive notifications when this workflow completes. Use id for updates/deletes, omit for creates. example: - id: workflow_webhook_url_01h2x3y4z5a6b7c8d9e0f1g2h3 url: https://example.com/webhook1 - url: https://example.com/webhook2 useProxy: type: boolean description: Whether to use proxy for this workflow example: false operatingSystem: type: - string - 'null' enum: - Windows - MacOS - Linux description: Operating system for browser sessions example: Windows fingerprintBrowser: type: string enum: - Chrome - Safari description: Browser fingerprint to use for sessions example: Safari maxConcurrentSessions: type: - integer - 'null' exclusiveMinimum: 0 description: Maximum concurrent executions for this workflow example: 10 useLoginDetection: type: boolean description: Whether to use login detection for this workflow example: true retryConfiguration: type: - object - 'null' properties: delay: type: integer exclusiveMinimum: 0 description: Retry delay in milliseconds example: 1000 retryCount: type: integer minimum: 1 description: Number of retries to attempt example: 3 required: - delay - retryCount description: >- Retry configuration for failed blocks. Set to null to remove retries. blockRetryCount: type: - integer - 'null' minimum: 0 description: Number of retries for failed blocks example: 3 blockBackoffStrategy: type: - string - 'null' enum: - exponential - linear description: Backoff strategy for block retries example: exponential isOptimizedForComputerVision: type: boolean description: >- Whether this workflow is optimized for computer vision blocks (uses specialized viewport and settings) example: true waitBetweenBlocksMs: type: integer minimum: 0 description: Wait time in milliseconds between executing each block example: 1000 tagIds: type: array items: type: string description: List of tag external IDs to associate with this workflow example: - tag_01h2x3y4z5a6b7c8d9e0f1g2h3 - tag_01h2x3y4z5a6b7c8d9e0f1g2h4 workflowGroupId: type: - string - 'null' description: >- External ID of the workflow group to assign this workflow to. Set to null to remove from any group. example: workflow_group_01h2x3y4z5a6b7c8d9e0f1g2h3 useRecoveryAgent: type: boolean description: >- Whether to enable the recovery agent for all blocks in this workflow. When enabled, all blocks will use the recovery agent regardless of their individual settings. example: false executionMode: type: string enum: - standard - structured description: >- Execution mode for this workflow. "standard" is the default, "structured" is experimental visual mode. example: standard executeInAgentMode: type: boolean description: >- Whether this workflow should execute in agent mode instead of traditional block-based execution. example: false agentModeSummarySchema: type: - object - 'null' additionalProperties: {} description: >- JSON Schema that defines the structure of the execution summary when running in agent mode. Set to null to remove. required: - workflowId required: true responses: '200': description: Workflow updated successfully content: application/json: schema: type: object properties: id: type: string description: ID of the updated workflow name: type: string description: Updated name of the workflow isAuthenticationRequired: type: boolean description: Whether authentication is required for this workflow autoSaveEnabled: type: boolean description: Whether auto-save is enabled for this workflow timeoutMs: type: - integer - 'null' description: Timeout in milliseconds for workflow execution example: 3600000 shouldPauseOnError: type: boolean description: Whether to pause workflow execution on error example: false shouldSelfHeal: type: boolean description: >- Whether to automatically clean up cache when workflow execution fails example: true shouldSaveResultFile: type: boolean description: Whether to save result files for this workflow example: false maxConcurrentSessions: type: - integer - 'null' exclusiveMinimum: 0 description: Maximum concurrent executions for this workflow example: 10 model: oneOf: - type: string enum: - gpt-4.1-mini-2025-04-14 - gpt-4.1-2025-04-14 - gpt-5.1-2025-11-13 - gpt-5.4 - gpt-5.4-mini - gpt-5.4-nano - type: string enum: - gemini-2.5-computer-use-preview-10-2025 - gemini-3.1-pro-preview - gemini-3.1-flash-lite - gemini-3.5-flash - type: string enum: - claude-haiku-4-5 - claude-sonnet-4-5 - claude-sonnet-4-6 - claude-opus-4-6 description: The LLM model used for this workflow useProxy: type: boolean description: Whether to use proxy for this workflow example: false useLoginDetection: type: boolean description: Whether to use login detection for this workflow example: true operatingSystem: type: - string - 'null' enum: - Windows - MacOS - Linux description: Operating system for browser sessions example: Windows fingerprintBrowser: type: string enum: - Chrome - Safari description: Browser fingerprint to use for sessions example: Safari blockRetryCount: type: - integer - 'null' minimum: 0 description: Number of retries for failed blocks example: 3 blockBackoffStrategy: type: - string - 'null' enum: - exponential - linear description: Backoff strategy for block retries example: exponential isOptimizedForComputerVision: type: boolean description: >- Whether this workflow is optimized for computer vision blocks (uses specialized viewport and settings) example: true waitBetweenBlocksMs: type: integer minimum: 0 description: Wait time in milliseconds between executing each block example: 1000 useRecoveryAgent: type: boolean description: >- Whether to enable the recovery agent for all blocks in this workflow. When enabled, all blocks will use the recovery agent regardless of their individual settings. example: false executionMode: type: string enum: - standard - structured description: >- Execution mode for this workflow. "standard" is the default, "structured" is experimental visual mode. example: standard executeInAgentMode: type: boolean description: >- Whether this workflow should execute in agent mode instead of traditional block-based execution. example: false agentModeSummarySchema: type: - object - 'null' additionalProperties: {} description: >- JSON Schema that defines the structure of the execution summary when running in agent mode. message: type: string description: Success message example: Workflow updated successfully required: - id - name - isAuthenticationRequired - autoSaveEnabled - model - message '400': description: Bad request '401': description: Unauthorized '404': description: Workflow not found '500': description: Internal server error ````