Forward セッションのイベント履歴を一覧取得します。
GET /api/v1/forward/sessions/{session_id}/events
セッションイベントをカーソルページネーションとフィールドレベルフィルタリングで返します。Session でレガシー増分ストリーミングが有効な場合、生成されたレガシー増分イベントも含まれます。event_deltas[] で購読したイベントデルタストリームイベントは履歴結果に表示されません。
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <PAT または SAT> |
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | Yes | Session ID。 |
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
limit | integer | No | 20 | 1 ページあたりの件数。最大 100。 |
after_id | string | No | - | 指定した Event ID より後のイベント用のカーソル。 |
before_id | string | No | - | 指定した Event ID より前のイベント用のカーソル。 |
order | string | No | asc | ソート順: asc または desc。 |
type | string | No | - | Event の種類でフィルターします。カンマ区切りの値に対応。 |
types[] | string | No | - | 配列形式の Event 種類フィルター。 |
include_tool_calls | boolean | No | true | ツール呼び出しイベントを含めます。 |
include_thinking | boolean | No | true | 思考イベントを含めます。 |
Example request
Example response
HTTP 200 OK
Response fields
| Field | Type | Description |
|---|---|---|
data | array | 現在のページの Event オブジェクト。 |
first_id | string|null | このページの最初のイベントの ID。 |
last_id | string|null | このページの最後のイベントの ID。 |
has_more | boolean | さらにレコードが残っているかどうか。 |
Event fields
| Field | Type | Description |
|---|---|---|
id | string | Event ID。 |
type | string | Event の種類。 |
session_id | string | Session ID。 |
processed_at | string | 利用可能な場合の処理タイムスタンプ。 |
content | array | メッセージ系のイベントで返されます。 |
Event payload fields by type
以下の表は、共通のエンベロープフィールド id、type、session_id、processed_at に加えて許可されるペイロードフィールドを示します。
| Event type | Payload fields |
|---|---|
user.message | content, file_attachments |
user.interrupt | reason |
user.tool_confirmation | tool_use_id, result, deny_message |
user.tool_result | tool_use_id, content, is_error |
user.custom_tool_result | custom_tool_use_id, content, is_error |
user.define_outcome | description, rubric, outcome_id, max_iterations |
agent.message | content |
agent.thinking | thinking, text |
agent.message_start | message_id, message |
agent.content_block_start | message_id, index, content_block |
agent.content_block_delta | message_id, index, delta |
agent.content_block_stop | message_id, index |
agent.message_delta | message_id, delta, usage |
agent.message_stop | message_id |
event_start | event |
event_delta | event_id, delta |
agent.tool_use | name, input, evaluated_permission |
agent.tool_result | tool_use_id, content, is_error |
agent.custom_tool_use | name, input |
agent.mcp_tool_use | mcp_server_name, name, input, evaluated_permission |
agent.mcp_tool_result | mcp_tool_use_id, content, is_error |
agent.artifact_delivered | file_id, original_filename, size, content_type |
session.status_running | None |
session.status_idle | stop_reason |
session.status_terminated | None |
session.thread_created | session_thread_id |
session.thread_status_running | session_thread_id |
session.thread_status_idle | session_thread_id, stop_reason |
session.thread_status_rescheduled | session_thread_id |
session.thread_status_terminated | session_thread_id |
session.error | error |
session.updated | agent, metadata, title |
span.model_request_end | is_error, model_request_start_id, model_usage |
| Unknown type | エンベロープのみ。ランタイムのプライベートな生ペイロードは返されません。 |
event_start と event_delta は event_deltas[] で SSE を購読した場合のみ返されます。履歴クエリ結果には表示されません。
Errors
| HTTP | Type | Code | Trigger |
|---|---|---|---|
| 400 | invalid_request_error | invalid_event_cursor | カーソルがこの Session に属していない。 |
| 400 | invalid_request_error | invalid_pagination | ページネーションパラメーターが無効。 |
| 401 | authentication_error | authentication_required | PAT または SAT が無効または期限切れ。 |
| 404 | not_found_error | session_not_found | Session が存在しない。 |
Notes
- 未知の Event 種類はリクエストを失敗させません。利用可能な場合は最小限のエンベロープで返されます。
- Forward は、エージェント ID、環境 ID、リソース、ボールト、ワーカー ID、トレース、生／デバッグ／内部のペイロードといったランタイムのプライベートフィールドをフィルタリングします。