GET
/
api
/
workflows
/
{workflowName}
/
runs
列出运行记录
curl --request GET \
  --url https://wfapi.yuhe.space/api/workflows/{workflowName}/runs \
  --header 'Authorization: Bearer <token>'
{
  "errCode": 123,
  "errMessage": "<string>",
  "data": [
    {
      "runId": "<string>",
      "workflowName": "<string>",
      "target": "<string>",
      "resolvedTarget": "<string>",
      "args": [
        "<string>"
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "durationMs": 123,
      "exitCode": 123,
      "conversationId": "<string>",
      "external": {
        "principalKind": "<string>",
        "actorType": "<string>",
        "actorUserId": "<string>",
        "actorProfileId": "<string>",
        "actorDisplayName": "<string>",
        "apiKeyId": "<string>",
        "apiKeyName": "<string>",
        "user": "<string>",
        "conversationId": "<string>",
        "inputs": {},
        "files": [
          "<unknown>"
        ],
        "webhook": {
          "workflowName": "<string>",
          "requestId": "<string>",
          "target": "<string>",
          "resolvedTarget": "<string>",
          "headers": {}
        }
      },
      "debugNode": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

使用 WORKFLOW_SERVER_ADMIN_KEY 或已创建的账号 API Key。

Path Parameters

workflowName
string
required

Query Parameters

limit
integer

兼容模式。传入后响应 data 仍是 WorkflowRunSummary 数组。

Required range: x >= 1
pageSize
integer

分页模式每页数量;显式传 pageSize、cursor、status、q 或 includeDraft 时启用分页响应。

Required range: 1 <= x <= 50
cursor
string

上一页返回的 nextCursor。

status
enum<string>

可选运行状态过滤。

Available options:
waiting,
running,
waiting_for_input,
success,
failed,
aborted,
timed_out
q
string

按 run id、workflow、conversation、target 或 resolved target 搜索。

includeDraft
boolean

分页模式是否包含 draft run;server web 传 false 以便在分页前排除 draft。

Response

200 - application/json

运行摘要列表。无查询参数或传 limit 为旧数组响应;显式传分页/过滤参数为分页响应。

errCode
integer
required
errMessage
string
required
Allowed value: ""
data
object[]
required