メインコンテンツへスキップ
GET /api/v1/forward/sessions/{session_id}/events/stream セッションイベントを Server-Sent Events としてストリーミングします。data ペイロードは、イベント履歴エンドポイントと同じ Forward フィルタリングモデルを使用します。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>
AcceptYestext/event-stream
Last-Event-IDNoこの Event ID の後から再開します。

​
Path parameters

ParameterTypeRequiredDescription
session_idstringYesSession ID。

​
Query parameters

ParameterTypeRequiredDefaultDescription
typestringNo-Event の種類でフィルターします。カンマ区切りの値に対応。
types[]stringNo-配列形式の Event 種類フィルター。
include_tool_callsbooleanNotrueツール呼び出しイベントを含めます。
include_thinkingbooleanNotrue思考イベントを含めます。

​
Example request

curl -N -X GET 'https://api.qoder.com/api/v1/forward/sessions/sess_xxx/events/stream?include_thinking=false' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Accept: text/event-stream"

​
Example response

HTTP 200 OK 
id: evt_xxx
event: agent.message
data: {"id":"evt_xxx","type":"agent.message","session_id":"sess_xxx","content":[{"type":"text","text":"Here is the analysis result."}],"processed_at":"2026-06-22T11:00:03Z"}

​
Incremental streaming example

Session が incremental_streaming_enabled=true で作成された場合、ストリームには最終的な agent.message の前に増分イベントが含まれることがあります。 
id: evt_start_xxx
event: agent.message_start
data: {"id":"evt_start_xxx","type":"agent.message_start","session_id":"sess_xxx","message_id":"msg_xxx","created_at":"2026-06-22T11:00:01Z"}

id: evt_delta_xxx
event: agent.content_block_delta
data: {"id":"evt_delta_xxx","type":"agent.content_block_delta","session_id":"sess_xxx","message_id":"msg_xxx","index":0,"delta":{"type":"text_delta","text":"Here"},"created_at":"2026-06-22T11:00:01Z"}

​
Response fields

FieldDescription
idSSE イベント ID。Event ID と等しくなります。
eventEvent の種類。
dataフィルタリング済みの Forward Event JSON。ペイロードフィールドは List Session Events に記載された Event type のマトリクスに従います。

​
Errors

HTTPTypeCodeTrigger
400invalid_request_errorinvalid_event_cursorLast-Event-ID がこの Session に属していない。
401authentication_errorauthentication_requiredPAT が無効または期限切れ。
404not_found_errorsession_not_foundSession が存在しない。

​
Notes

  • 増分ストリーミングは Session の作成リクエストで制御され、このエンドポイントで有効化することはできません。
  • 未知の Event 種類は、利用可能な場合はエンベロープのみのイベントとして転送されます。
  • include_thinking=false は思考イベントと認識可能な思考デルタをフィルタリングします。
  • include_tool_calls=false はツール使用イベントと認識可能なツール入出力デルタをフィルタリングします。

セッションの作成

セッションイベントの一覧取得