イベントの一覧取得

GET /api/v1/cloud/sessions/{session_id}/events カーソルページネーションで Session の公開イベントを取得します。Accept ヘッダーで text/event-stream を要求した場合、このルートは SSE ストリーミングに切り替わります。ページネーションされた JSON レスポンスを得るには Accept: application/json を指定するか、SSE のメディアタイプを省略してください。

パスパラメータ

パラメータ	型	説明
`session_id`	string	`sess_` プレフィックス付きの Session ID

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer $QODER_ACCESS_TOKEN`

クエリパラメータ

パラメータ	型	必須	説明
`limit`	integer	いいえ	返すイベントの最大数。デフォルトは 20、範囲は 1〜100。100 を超える値は `400 invalid_request_error` を返します。
`page`	string	いいえ	前回のレスポンスの `next_page` から得られる不透明なカーソル。`before_id` および `after_id` とは排他的です
`before_id`	string	いいえ	このイベント ID より前の順序のイベントを返します。`page` および `after_id` とは排他的です
`after_id`	string	いいえ	このイベント ID より後の順序のイベントを返します。`page` および `before_id` とは排他的です
`order`	string	いいえ	ソート方向: `asc`（デフォルト）または `desc`
`types`	string または array	いいえ	イベントタイプでフィルタします。認識されないイベントタイプは無視され、レスポンスには一致するイベントが含まれないだけです
`created_at[gt]`	string	いいえ	この RFC 3339 タイムスタンプより後に作成されたイベントを返します
`created_at[gte]`	string	いいえ	この RFC 3339 タイムスタンプ以降に作成されたイベントを返します
`created_at[lt]`	string	いいえ	この RFC 3339 タイムスタンプより前に作成されたイベントを返します
`created_at[lte]`	string	いいえ	この RFC 3339 タイムスタンプ以前に作成されたイベントを返します

リクエスト例

curl -X GET "https://api.qoder.com/api/v1/cloud/sessions/sess_019e392c0d1e74e095d21ea4c6b41def/events?limit=5&types=user.message,agent.message" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

レスポンス例

HTTP 200 OK

{
  "data": [
    {
      "id": "evt_019e392c0d787cfaa21bda98e06cd913",
      "type": "user.message",
      "content": [
        {"type": "text", "text": "Hello, this is a test message."}
      ],
      "processed_at": "2026-05-18T03:40:48.888851795Z"
    },
    {
      "id": "evt_771c1195bcbd4a07834d4ed4dd6450ca",
      "type": "agent.message",
      "content": [
        {"type": "text", "text": "Hello! How can I help you today?"}
      ],
      "processed_at": "2026-05-18T03:40:55.123Z"
    }
  ],
  "first_id": "evt_019e392c0d787cfaa21bda98e06cd913",
  "has_more": false,
  "last_id": "evt_771c1195bcbd4a07834d4ed4dd6450ca",
  "next_page": null
}

イベントタイプ

list および stream エンドポイントが公開するイベントタイプの全一覧は公開イベントタイプを参照してください。

レスポンスフィールド

フィールド	型	説明
`data`	array	公開 Event オブジェクトのリスト
`has_more`	boolean	このページの先にさらに結果があるかどうか
`first_id`	string \| null	現在のページの最初のイベントの ID
`last_id`	string \| null	現在のページの最後のイベントの ID
`next_page`	string \| null	次ページの不透明なカーソル。結果がそれ以上ない場合は `null`

エラー

HTTP	タイプ	トリガー条件
400	`invalid_request_error`	不正な `limit`（非整数または非正値)、不正な `order`、不正なタイムスタンプフィルタ、または `page` と `before_id`/`after_id` の同時指定
401	`authentication_error`	PAT または SAT が無効または期限切れ

| 404 | not_found_error | Session が存在しません。エラーメッセージは Session '<session_id>' was not found. |

例: 400 不正な `order`

{
  "error": {
    "message": "Field 'order' must be one of: asc, desc.",
    "type": "invalid_request_error"
  },
  "request_id": "74c9b7ee-f2f4-450a-9283-933fd3315cf8",
  "type": "error"
}

例: 400 不正な `limit`

{
  "error": {
    "message": "Field 'limit' must be a positive integer.",
    "type": "invalid_request_error"
  },
  "request_id": "d582074b-11ec-45cb-9c94-929278a19261",
  "type": "error"
}

完全なエラーエンベロープについてはエラーを参照してください。

Session イベントストリーム

Agent の思考、メッセージ、ツール呼び出し、ステータスを SSE でストリーミングします。

​パスパラメータ

​ヘッダー

​クエリパラメータ

​リクエスト例

​レスポンス例

​イベントタイプ

​レスポンスフィールド

​エラー

​例: 400 不正な order

​例: 400 不正な limit

​関連項目