跳转到主要内容
POST
/
safari
/
session
/
list
查询会话列表
curl --request POST \
  --url 'https://api.flashcat.cloud/safari/session/list?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "app_name": "ai-sre",
  "limit": 2,
  "orderby": "updated_at",
  "scope": "all"
}
'
{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "total": 988,
    "sessions": [
      {
        "session_id": "sess_f8oDvqiG64uur6sBNsTc4u",
        "session_name": "Investigate cloud-assistant first heartbeat",
        "app_name": "ai-sre",
        "entry_kind": "web",
        "person_id": "3790925372131",
        "team_id": 0,
        "is_mine": false,
        "can_manage": true,
        "status": "enabled",
        "incognito": false,
        "created_at": 1780367971228,
        "updated_at": 1780367993457,
        "token_usage": {
          "input_tokens": 14948,
          "cached_tokens": 11520,
          "output_tokens": 888,
          "reasoning_tokens": 351
        },
        "current_context_tokens": 14948,
        "context_window": 0,
        "archived_at": 0,
        "pinned_at": 0,
        "last_event_at": 1780367992649,
        "is_running": false,
        "has_unread": true
      }
    ]
  }
}

​
限制说明

项目说明
速率限制每个 app_key 1,000 次/分钟；50 次/秒
权限要求无 —— 持有有效的 app_key 即可调用

​
使用说明

  • 分页使用 p/limit（最大 100）；scope 默认 all（本人 + 所属团队）。
  • is_running 反映实时运行集合；has_unread 按调用者各自计算。

授权

​
app_key
string
query
必填

App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.

请求体

application/json

查询智能体会话列表的过滤条件。读取范围限定为解析出的账户及调用者可见的团队。

​
app_name
enum<string>
必填

要查询其会话的智能体应用。

可用选项:
ask-ai,
support,
support-website,
support-flashcat,
ai-sre,
template-assistant,
swe
​
p
integer
默认值:1

页码，从 1 开始。

必填范围: x >= 1
​
limit
integer
默认值:20

每页数量，1–100。

必填范围: 1 <= x <= 100
​
orderby
enum<string>

排序字段。

可用选项:
created_at,
updated_at
​
asc
boolean

为 true 时升序；仅在设置 orderby 时生效。

​
include_subagent_sessions
boolean

是否在列表中包含子智能体派生的会话。

​
keyword
string

按会话名称关键字过滤。

Maximum string length: 64
​
scope
enum<string>

可见范围：all（本人 + 所属团队，默认）、personal 或 team。

可用选项:
all,
personal,
team
​
team_ids
integer<int64>[]

可选的团队过滤；与 scope 取交集。

​
entry_kinds
enum<string>[]

仅返回由这些入口产生的会话；为空则返回所有类型。

可用选项:
web,
im,
api,
automation
​
status
enum<string>

归档分桶：active（默认）返回未归档，archived 返回已归档，all 返回全部。

可用选项:
active,
archived,
all

响应

Success

Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.

​
request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

​
error
object

Error payload inside the response envelope. Present only on non-2xx responses.

​
data
object

一页智能体会话。