---
title: "Execute a workflow"
method: POST
path: "/workflows/execute"
tags: ["Workflows"]
---

# Execute a workflow

`POST /workflows/execute`

Executes a workflow with the specified login and parameters

## Request body

- object
  - `workflowId` string — ID of the workflow to execute. Either workflowId or workflowName must be provided.
  - `workflowName` string — 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` string — ID of the login to use for authentication
  - `params` object, required — Runtime parameters for the workflow execution
  - `name` union — Optional name for the execution (string or number, automatically converted to string)
    - string
    - number
  - `timeout` integer — Optional timeout in seconds for the execution (defaults to 10800 seconds / 3 hours)
  - `useProxy` boolean — Whether to use a proxy for this execution
  - `startBlockId` string — Optional ID of the block to start execution from
  - `batchId` string — Optional ID of the execution batch to assign this execution to
  - `isTest` boolean — Whether this execution is a test run
  - `agentConversationThreadId` string — Optional ID of an agent conversation thread to associate with this execution (used when duplicating executions that were triggered by an agent)

## Response `200`

Workflow execution started successfully

- object
  - `executionId` string, required — ID of the created execution
  - `status` string, required — Status of the execution
  - `message` string, required — Message about the execution

## Other responses

- `400` — Invalid request parameters
- `404` — Workflow or login not found
- `500` — Server error

---

[API](https://skmtc.dev/kaizenautomation/apis/kaizen-api.md) · [All operations](https://skmtc.dev/kaizenautomation/apis/kaizen-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kaizenautomation/kaizen-api/revisions/4aa3664ceff2/schema)