查询会话列表

分页查询调用者可见的智能体会话，可按应用、入口、归档状态与团队过滤。

POST /safari/session/list

查询会话列表

cURL

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"
}
'

import requests

url = "https://api.flashcat.cloud/safari/session/list?app_key="

payload = {
    "app_name": "ai-sre",
    "limit": 2,
    "orderby": "updated_at",
    "scope": "all"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({app_name: 'ai-sre', limit: 2, orderby: 'updated_at', scope: 'all'})
};

fetch('https://api.flashcat.cloud/safari/session/list?app_key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flashcat.cloud/safari/session/list?app_key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'app_name' => 'ai-sre',
    'limit' => 2,
    'orderby' => 'updated_at',
    'scope' => 'all'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flashcat.cloud/safari/session/list?app_key="

	payload := strings.NewReader("{\n  \"app_name\": \"ai-sre\",\n  \"limit\": 2,\n  \"orderby\": \"updated_at\",\n  \"scope\": \"all\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/safari/session/list?app_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"app_name\": \"ai-sre\",\n  \"limit\": 2,\n  \"orderby\": \"updated_at\",\n  \"scope\": \"all\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flashcat.cloud/safari/session/list?app_key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"app_name\": \"ai-sre\",\n  \"limit\": 2,\n  \"orderby\": \"updated_at\",\n  \"scope\": \"all\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "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_view": true,
        "can_continue": true,
        "can_manage": true,
        "can_fork": true,
        "access_source": "manager",
        "share_enabled": true,
        "share_version": 3,
        "shared_at": 1780367971000,
        "shared_by": 3790925372131,
        "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,
        "current_turn_started_at": 0,
        "current_turn_active_ms": 0,
        "current_turn_wait_ms": 0,
        "current_turn_tokens": 0
      }
    ],
    "suggest_init": false
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InvalidParameter",
    "message": "The specified parameter skill_id is not valid."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "Unauthorized",
    "message": "You are unauthorized."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "AccessDenied",
    "message": "Access Denied."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "RequestTooFrequently",
    "message": "Request too frequently."
  }
}

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "error": {
    "code": "InternalError",
    "message": "We encountered an internal error, and it has been reported. Please try again later."
  }
}

​

限制说明

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

​

使用说明

• 分页使用 p/limit（最大 100）；scope 默认 all。
• all 返回调用者自己的个人会话，以及调用者可访问团队的团队会话；账户管理员可见所有团队会话，但不可见他人的个人会话。
• team_ids 只会收窄可见集合，不会扩大访问范围。
• is_running 反映实时运行集合；has_unread 按调用者各自计算；current_turn_* 字段在此接口恒为 0 —— 仅 session/get 会在会话运行时计算它们。
• suggest_init 是账户级的引导提示（仅当账户在任何范围内都没有知识包时为 true），与列表过滤条件无关。

授权

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

查询智能体会话列表的过滤条件。all 表示调用者自己的个人会话和可访问团队的团队会话；账户管理员不可见他人的个人会话。

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。

可用选项: 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

响应

200

application/json

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.

Show child attributes

data · object

一页智能体会话。

Show child attributes