> ## 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.

# Execute a workflow

> Executes a workflow with the specified login and parameters



## OpenAPI

````yaml post /workflows/execute
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/execute:
    post:
      tags:
        - Workflows
      summary: Execute a workflow
      description: Executes a workflow with the specified login and parameters
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                workflowId:
                  type: string
                  description: >-
                    ID of the workflow to execute. Either workflowId or
                    workflowName must be provided.
                workflowName:
                  type: string
                  description: >-
                    Name of the workflow to execute. If provided, the workflow
                    will be looked up by name within the organization. Either
                    workflowId or workflowName must be provided.
                loginId:
                  type: string
                  description: ID of the login to use for authentication
                params:
                  type: object
                  additionalProperties: {}
                  description: Runtime parameters for the workflow execution
                  example:
                    origin: New York
                    destination: Los Angeles
                name:
                  oneOf:
                    - type: string
                    - type: number
                  description: >-
                    Optional name for the execution (string or number,
                    automatically converted to string)
                  examples:
                    - User batch execution
                    - 12345
                    - Execution-001
                timeout:
                  type: integer
                  exclusiveMinimum: 0
                  description: >-
                    Optional timeout in seconds for the execution (defaults to
                    10800 seconds / 3 hours)
                  example: 10800
                useProxy:
                  type: boolean
                  description: Whether to use a proxy for this execution
                  default: false
                startBlockId:
                  type: string
                  description: Optional ID of the block to start execution from
                  example: '1'
                batchId:
                  type: string
                  description: >-
                    Optional ID of the execution batch to assign this execution
                    to
                  example: batch_123
                isTest:
                  type: boolean
                  description: Whether this execution is a test run
                  default: false
                agentConversationThreadId:
                  type: string
                  description: >-
                    Optional ID of an agent conversation thread to associate
                    with this execution (used when duplicating executions that
                    were triggered by an agent)
              required:
                - params
      responses:
        '200':
          description: Workflow execution started successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  executionId:
                    type: string
                    description: ID of the created execution
                    example: '1'
                  status:
                    type: string
                    description: Status of the execution
                    example: Processing
                  message:
                    type: string
                    description: Message about the execution
                    example: Workflow execution started successfully
                required:
                  - executionId
                  - status
                  - message
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Workflow or login not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                    example: Workflow not found or does not belong to this organization
                required:
                  - error

````