Session Thread Event の一覧

GET /api/v1/forward/sessions/{session_id}/threads/{thread_id}/events

パラメーター

場所	パラメーター	型	必須	デフォルト	説明
Header	Authorization	string	はい	-	`Bearer <PAT または SAT>`
Path	session_id	string	はい	-	`sess_` プレフィックス付きの Session ID。
Path	thread_id	string	はい	-	`sthr_` プレフィックス付きの Thread ID。
Query	limit	integer	いいえ	20	1～100 のページサイズ。
Query	after_id	string	いいえ	-	この Event ID より後のレコードを返します。
Query	before_id	string	いいえ	-	この Event ID より前のレコードを返します。

after_id と before_id を同時に指定することはできません。結果は常に昇順です。 Thread Event 履歴は order、type、types、types[]、include_tool_calls、include_thinking、event_deltas[] をサポートしません。空の値であっても指定すると 400 invalid_request が返されます。

リクエスト例

curl -s -X GET 'https://api.qoder.com/api/v1/forward/sessions/sess_xxx/threads/sthr_child_xxx/events?limit=20' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

{
  "data": [{
    "id": "evt_xxx",
    "type": "agent.message",
    "session_id": "sess_xxx",
    "content": [{ "type": "text", "text": "子タスクが完了しました。" }],
    "processed_at": "2026-06-22T11:05:00Z"
  }],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

フィールド	型	説明
data	array	このページの Event オブジェクト。
first_id	string \| null	最初の Event ID。空の場合は `null`。
last_id	string \| null	最後の Event ID。空の場合は `null`。
has_more	boolean	続きのレコードがあるかどうか。

エラー

HTTP	Type	Code	条件
400	`invalid_request`	`invalid_limit`	`limit` が 1～100 の整数ではありません。
400	`invalid_request`	`invalid_pagination`	`after_id` と `before_id` を同時に指定しました。
400	`invalid_request`	`invalid_request`	サポートされていない selector を指定しました。
401	`authentication_error`	`authentication_required`	PAT または SAT が無効または期限切れです。
404	`not_found`	`session_not_found`	Session が存在しないか、呼び出し元から参照できません。
404	`not_found_error`	`thread_not_found`	Thread が存在しないか、その Session に属していません。
502	`api_error`	`runtime_unavailable`	Thread ランタイムサービスが利用できません。

注記

Thread Event は Session Event と同じ公開フィールド投影を使用します。未知の Event タイプでは最小限の Event envelope のみが返されます。
Thread のアーカイブ後、このエンドポイントでは完全な message/tool 履歴を取得できません。親 Session の履歴またはストリームからライフサイクル Event を復旧し、Thread 取得エンドポイントで最終状態を確認してください。

Session Thread Event の一覧

パラメーター

リクエスト例

レスポンス例

エラー

注記

Thread Event Stream の購読

Session と Event のデータ構造

​パラメーター

​リクエスト例

​レスポンス例

​エラー

​注記

Thread Event Stream の購読

Session と Event のデータ構造

パラメーター

リクエスト例

レスポンス例

エラー

注記