イベントの送信

POST /api/v1/cloud/sessions/{session_id}/events 1 つ以上の受理可能なイベントを Session に送信します。user.message は非同期に Agent の処理をトリガーします。Agent の出力は list または stream エンドポイントで読み取ってください。

パスパラメータ

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

ヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer $QODER_ACCESS_TOKEN`
`Content-Type`	はい	`application/json`

リクエストボディ

フィールド	型	必須	説明
`events`	array	はい	空でないイベントオブジェクトの配列

サポートされるイベントタイプ

タイプ	必須フィールド	備考
`user.message`	`content`	`content` は空でない content block の配列でなければなりません
`user.interrupt`	なし	`session_thread_id` は任意です
`user.tool_confirmation`	`tool_use_id`、`result`	`result` は `allow` または `deny` でなければなりません。`deny_message` は任意で、`result = "deny"` の場合にのみ指定できます
`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`	`rubric` はオブジェクトで、`{"type":"text","content":"..."}` または `{"type":"file","file_id":"file_..."}` のいずれかです。未知のフィールドは拒否されます。`max_iterations` は任意で、1 から 20 の整数でなければなりません。`outcome_id`（`outc_` プレフィックス）はサーバーが割り当てるため、クライアントは指定できません

文字列形式の events[].content はサポートされません。イベントに content フィールドがある場合は、content block の配列として送信してください。

リクエスト例

{
  "data": [
    {
      "id": "evt_019e3bb2c153764da54e4d3acbef52b6",
      "type": "user.message",
      "content": [
        {"type": "text", "text": "Help me analyze the performance of this code."}
      ],
      "processed_at": "2026-05-18T15:27:11.187413896Z"
    }
  ]
}

レスポンス例

HTTP 200 OK

{
  "events": [
    {
      "type": "user.tool_confirmation",
      "tool_use_id": "evt_01JZ6Q3FB6SG8F7J1M2N",
      "result": "deny",
      "deny_message": "Do not delete files in this directory."
    }
  ]
}

Human-in-the-loop レスポンス

ストリームが確認を必要とする agent.tool_use を発行したら、user.tool_confirmation で応答します。

{
  "events": [
    {
      "type": "user.tool_result",
      "tool_use_id": "evt_01JZ6Q3FB6SG8F7J1M2N",
      "content": [{"type": "text", "text": "Command completed successfully."}],
      "is_error": false
    }
  ]
}

ストリームが agent.custom_tool_use を発行したら、クライアント側でツールを実行し、user.custom_tool_result で応答します。

{
  "events": [
    {
      "type": "user.custom_tool_result",
      "custom_tool_use_id": "evt_01JZ6R1V9Z8K2M3N4P5Q",
      "content": [{"type": "text", "text": "Order status: shipped"}]
    }
  ]
}

エラー

HTTP	タイプ	トリガー条件
400	`invalid_request_error`	`events` が空、サポートされないイベントタイプ、必須フィールドの欠落、不正な content block、またはサポートされないレガシーフィールド
401	`authentication_error`	PAT または SAT が無効または期限切れ
404	`not_found_error`	Session または保留中のアクションが存在しない
409	`invalid_request_error`	Session が現在ターンを処理中、またはその他の Session 状態の競合（注意: `type` は `conflict_error` ではなく `invalid_request_error` です）

例: 400 不正な `content`

user.message に content block の配列ではなくプレーンな文字列を送信した場合:

{
  "error": {
    "message": "Field 'content' must be a non-empty array of content blocks.",
    "type": "invalid_request_error"
  },
  "request_id": "2c9d3d8a-dd0f-4c27-b2ad-24c8719c97e1",
  "type": "error"
}

例: 404 Session が見つからない

{
  "error": {
    "message": "Session 'sess_doesnotexist_xxxxxxxxxxxxxxxxxxxxxxxx' was not found.",
    "type": "not_found_error"
  },
  "request_id": "590c2a0c-1656-42d3-ba0c-32c755d22e77",
  "type": "error"
}

例: 409 Session が実行中

Session がすでにターンを処理しているときに user.message を送信した場合:

{
  "error": {
    "message": "Session is currently processing a turn. Cancel the current turn or wait for completion.",
    "type": "invalid_request_error"
  },
  "request_id": "ba018d2f-d6b0-4bbe-a53c-2241baca34fe",
  "type": "error"
}

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

Session イベントストリーム

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

​パスパラメータ

​ヘッダー

​リクエストボディ

​サポートされるイベントタイプ

​リクエスト例

​レスポンス例

​Human-in-the-loop レスポンス

​エラー

​例: 400 不正な content

​例: 404 Session が見つからない

​例: 409 Session が実行中

​関連項目