---
title: "Execute a Workflow"
method: POST
path: "/v1/workflows/{workflowId}/executions"
tags: ["Executions API"]
---

# Execute a Workflow

`POST /v1/workflows/{workflowId}/executions`

Use this endpoint to start a new workflow execution. The request returns immediately with a `pending` status. Use the Idempotency-Key header to ensure safe retries.

## Path parameters

- `workflowId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- ExecuteWorkflowInput
  - `inputData` object, required — Input data passed to the workflow. Available to all nodes during execution. Maximum payload size is 1 MB.

## Response `200`

Indicates that an identical request was already processed. Returns the original execution.

- ExecutionCreateOutput
  - `executionId` string, uuid — Unique identifier of the execution.
  - `startedAt` string, date-time — Timestamp when the execution started.
  - `status` string — Initial status of the execution (always `pending`).
  - `workflowId` string, uuid — ID of the workflow being executed.

## Other responses

- `201` — Indicates that the resource was successfully created and the operation was completed as expected.
- `400` — Indicates that the request was malformed or contained invalid parameters.
- `404` — Indicates that the requested resource could not be found.
- `413` — Indicates that the request payload exceeds the maximum allowed size.
- `422` — Indicates that the request was well-formed but contains semantic errors that prevent processing.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)