Skip to main content
POST
创建会话
创建会话后,保存响应中的 id,后续读取、更新和运行均使用同一应用、用户和会话标识。未提供 sessionId 时由服务生成 ID;重复创建已存在的指定 ID 返回 409 请求中的 state 用于初始化会话状态,events 用于导入已有事件。无需导入历史时省略 events,创建会话本身不会调用模型

授权

Authorization
string
header
必填

本地未配置网关时可不提供;云部署使用 Runtime API Key 或部署要求的用户池 JWT,不能使用模型 API Key

路径参数

app_name
string
必填

应用名称,CLI 部署版为 harness_agent

user_id
string
必填

用户 ID

请求体

application/json
sessionId
string | null

要创建的会话 ID;省略时自动生成

state
State · object | null

会话的初始状态

events
Event · object[] | null

用于初始化会话的事件列表

响应

请求成功

id
string
必填

标识符

appName
string
必填

应用名称

userId
string
必填

用户 ID

state
State · object

会话状态的键值对象

events
Event · object[]

会话事件列表

lastUpdateTime
number
默认值:0

最近更新时间,Unix 时间戳,单位为秒

最后修改于 2026年9月19日