GET
/
api
/
workflows
/
{workflowName}
/
kv
列出项目 KV
curl --request GET \
  --url https://wfapi.yuhe.space/api/workflows/{workflowName}/kv \
  --header 'Authorization: Bearer <token>'
{
  "errCode": 123,
  "errMessage": "<string>",
  "data": {
    "items": [
      {
        "key": "<string>",
        "valueSizeBytes": 123,
        "valuePreview": "<string>",
        "updatedAt": "2023-11-07T05:31:56Z",
        "workflowName": "<string>",
        "conversationId": "<string>",
        "lastWorkflowName": "<string>",
        "lastRunId": "<string>",
        "lastConversationId": "<string>",
        "linkedRun": {
          "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>"
        }
      }
    ],
    "hasMore": true,
    "total": 123,
    "nextCursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

workflowName
string
required

Query Parameters

pageSize
integer
Required range: 1 <= x <= 100
cursor
string
scope
enum<string>
default:all

项目详情页只支持 workflow / conversation;不返回 global。

Available options:
all,
workflow,
conversation
q
string

按 key、conversation 或 last run 搜索。

valueType
enum<string>
Available options:
null,
array,
object,
string,
number,
boolean

按最后写入 run 是否仍有可打开的执行记录过滤。

Available options:
all,
linked,
unlinked
conversationId
string
runId
string

Response

200 - application/json

当前项目 workflow / conversation KV 分页。列表只返回 valuePreview、类型和大小等摘要,不返回完整 value

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