POST
/
api
/
workflows
/
{workflowName}
/
run
管理端运行 workflow
curl --request POST \
  --url https://wfapi.yuhe.space/api/workflows/{workflowName}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target": "latest",
  "args": [
    "--message",
    "hello"
  ],
  "conversation_id": "thread-1"
}
'
{
  "errCode": 123,
  "errMessage": "<string>",
  "data": {
    "runId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "target": "<string>",
    "resolvedTarget": "<string>",
    "args": [
      "<string>"
    ],
    "durationMs": 123,
    "stdout": "<string>",
    "stderr": "<string>",
    "exitCode": 123,
    "report": {},
    "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>",
    "pendingUserInput": {
      "requestId": "<string>",
      "nodeName": "<string>",
      "title": "<string>",
      "params": [
        {}
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "defaultValues": {},
      "metadata": {}
    },
    "resolvedUserInputs": [
      {
        "requestId": "<string>",
        "nodeName": "<string>",
        "values": {},
        "submittedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

workflowName
string
required

Body

application/json
target
string
Example:

"latest"

version
string

指定语义化版本号的别名;未提供 target 时会作为运行目标。

args
string[]
conversationId
string
conversation_id
string
toolPermissionPolicies
object
Example:
{
"search": { "enabled": true, "autoApprove": false }
}

Response

200 - application/json

运行结果。

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