---
title: "触发工作流运行（服务端执行）"
method: POST
path: "/workflows/{id}/run"
---

# 触发工作流运行（服务端执行）

`POST /workflows/{id}/run`

## Request

- Base URL: `https://pdflean.com/api/v1`
- URL: `https://pdflean.com/api/v1/workflows/{id}/run`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Request body

- RunInput
  - `fileIds` string[]: 已上传文件的 fileId（需属于该 API Key 用户）
  - `params` object: 运行级参数（与步骤参数合并，步骤优先）

## Response `200`

已入队

- Run
  - `runId` string
  - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'awaiting_approval' | 'canceled'

## Other responses

- `404`: 不存在

---

[API](https://skmtc.dev/pdflean/apis/pdflean-api.md) · [All operations](https://skmtc.dev/pdflean/apis/pdflean-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pdflean/apis/pdflean-api/revisions/fe391cfbf9f9?raw)