GET /api/v1/projects/{id}/sessions/{session_id}/runs
Bearer 認証

セッションの実行が最も古い順に実行され、それぞれのステップが順番に返されます。ステップは、その種類、実行期間内での開始オフセット、トークン数、ステータス、step_number を渡します。

path パラメータ

  • id string 必須

    プロジェクトID

  • Session_id string 必須

    セッションID

クエリ パラメータ

  • Workspace_id string

    ワークスペース解決のためのワークスペースID

応答

  • 406

    サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現（サポートされていないメディアタイプのパラメーター、または除外された SSE を含む）。既存の認証、認可、およびレート制限の失敗が優先されます。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。
  • 200

    OK

    応答属性の非表示 応答属性の表示 オブジェクト
    • count integer
    • 実行します array[オブジェクト]
      属性を非表示にする 実行属性の表示 オブジェクト
      • Active_ duration_ms integer
      • completed_tokens integer
      • duration_ms integer

        durationMS は、実行の開始から最後の更新までのウォール クロック時間です。

      • エラー string
      • error_code string
      • execution_id string
      • invoker_user_id string
      • memory_recals integer

        メモリを認識するメモリとメモリをカウントするメモリ ステップは、切り捨てられた読み取りの下限値です。

      • memory_saves integer
      • prompt_tokens integer

        PromptTokens と CompletionTokens は TotalTokenを分裂。実行に解決されたllmステップがない場合はどちらも存在しません。

      • run_number integer

        RunNumber は、セッション内の最も古い実行の 1 ベースの位置です。切り捨てが true である場合、それは代わりに返されたウィンドウを基準にします。最も古い実行は 上限に達して削除されるものです。そのため、実行 1 はセッションの最初ではありません。

      • Session_id string
      • slowest_step オブジェクト

        実行に解決されたステップがない場合、SlowestRead は存在しません。

        slowest_step 属性を非表示 slowest_step 属性の表示 オブジェクト
        • duration_ms 数値
        • kind string
        • name string
        • step_number integer
      • start_at string
      • startup_failure オブジェクト
        startup_failure 属性を非表示にする startup_failure 属性の表示 オブジェクト
        • boost_id string
        • コード string
        • コンポーネントは string
        • フェーズ string
        • ソース string
      • 状態 string
      • 手順 array[オブジェクト]
        ステップ属性を非表示にする ステップ属性の表示 オブジェクト
        • completed_tokens integer
        • duration_ms 数値

          durationMS は、まだ解決されていないステップには存在しません。

        • エラー string
        • kind string

          種類はステップのカテゴリです。llm、ツール、メモリ、文字列、ポリシー、a2a、または Agent_step

        • memory_op string

          memoryOp は "リコール" です。または "save" を使用します解決されたメモリ ステップ上の。それ以外の場合は存在しません。

        • name string
        • 発表 string
        • 提示_切り捨て ブール値
        • prompt_tokens integer

          PromptTokens と CompletionTokens は TotalTokenを分裂、どちらも解決されたllm ステップにのみ存在します。

        • review_outcome string

          ReviewOutcom、WaitMS、および ReviewTrigger は、人間がレビューする手順にのみ存在します。待機の状態（「保留中」の場合、「認証済み」/「拒否」）、その解決された長さ（ミリ秒単位）、および をルーティングしたガーフィールドレビューするための呼び出し

        • Review_trigger string
        • レビュー string

          Reviewer/ Reviewernotes/Prested は OA レビューレコードをミラーリングしています。つまり、人間、そのノート、および が確認した内容の Capped Excern を決定します。

        • Reviewer_notes string
        • run_id string

          RunID は、agent_step にのみ存在するグラフノード呼び出しの識別子です。これは、ノードステップを Node_execution 行に結合する唯一のキーです。

        • span_id string

          SpanID は、このステップを spansコレクション内の完全なトレース詳細に結合します。

        • start_opset_ms integer

          Start OpsetMS は、実行の開始からこのステップの開始までの ミリ秒です。

        • start_at string
        • 状態 string
        • step_number integer

          [] は、割り込みエンドポイントが対象とする値です。グラフ構造を記録し、中断可能なステップがありません。

        • tool_col_id string
        • total_tokens integer

          TotalTokens は解決済みのllmステップにのみ存在します。

        • wait_ms integer
      • 概要 string

        概要は の実行呼び出しメッセージで、サーバー側で切り捨てられます。

      • time_to_first_event_ms integer

        TimeToFirstEventMS は最初のステップのオフセットで、実行にまだステップがない場合は存在しません。

      • total_tokens integer

        TotalTokens は実行の解決されたllmステップを合計するため、実行が実際に費やした金額の下限になります。

      • user_id string

        ユーザー ID と InvoiceUserID は、実行の実行 ID をミラーリングします。委任の対象となるのは として実行された実行と、それを開始したゲートウェイ認証された呼び出し元です。どちらも存在しない場合があります - UE の SessionRun を参照してください。どちらもサポートセーフ ビューから省略されます。

      • wait_ms integer

        WaitMS は、実行の解決済み人間によるレビュー待機であり、実行が一時停止されない場合は存在しません。 ActiveDurationMS では次の待機は除外されます。はどちらも、それらに先行するオーケストレーションエンジンから存在しません。

      • Workspace_id string
    • 切り捨て ブール値

      切り捨てられた では、セッションが 1 回の読み取りで OA が返す行数よりも多くの行があることが報告されているため、これは部分的なビューです。 UE 応答からミラーリングされています。

    応答属性の非表示 応答属性の表示 オブジェクト
    • count integer
    • 実行します array[オブジェクト]
      属性を非表示にする 実行属性の表示 オブジェクト
      • Active_ duration_ms integer
      • completed_tokens integer
      • duration_ms integer

        durationMS は、実行の開始から最後の更新までのウォール クロック時間です。

      • エラー string
      • error_code string
      • execution_id string
      • invoker_user_id string
      • memory_recals integer

        メモリを認識するメモリとメモリをカウントするメモリ ステップは、切り捨てられた読み取りの下限値です。

      • memory_saves integer
      • prompt_tokens integer

        PromptTokens と CompletionTokens は TotalTokenを分裂。実行に解決されたllmステップがない場合はどちらも存在しません。

      • run_number integer

        RunNumber は、セッション内の最も古い実行の 1 ベースの位置です。切り捨てが true である場合、それは代わりに返されたウィンドウを基準にします。最も古い実行は 上限に達して削除されるものです。そのため、実行 1 はセッションの最初ではありません。

      • Session_id string
      • slowest_step オブジェクト

        実行に解決されたステップがない場合、SlowestRead は存在しません。

        slowest_step 属性を非表示 slowest_step 属性の表示 オブジェクト
        • duration_ms 数値
        • kind string
        • name string
        • step_number integer
      • start_at string
      • startup_failure オブジェクト
        startup_failure 属性を非表示にする startup_failure 属性の表示 オブジェクト
        • boost_id string
        • コード string
        • コンポーネントは string
        • フェーズ string
        • ソース string
      • 状態 string
      • 手順 array[オブジェクト]
        ステップ属性を非表示にする ステップ属性の表示 オブジェクト
        • completed_tokens integer
        • duration_ms 数値

          durationMS は、まだ解決されていないステップには存在しません。

        • エラー string
        • kind string

          種類はステップのカテゴリです。llm、ツール、メモリ、文字列、ポリシー、a2a、または Agent_step

        • memory_op string

          memoryOp は "リコール" です。または "save" を使用します解決されたメモリ ステップ上の。それ以外の場合は存在しません。

        • name string
        • 発表 string
        • 提示_切り捨て ブール値
        • prompt_tokens integer

          PromptTokens と CompletionTokens は TotalTokenを分裂、どちらも解決されたllm ステップにのみ存在します。

        • review_outcome string

          ReviewOutcom、WaitMS、および ReviewTrigger は、人間がレビューする手順にのみ存在します。待機の状態（「保留中」の場合、「認証済み」/「拒否」）、その解決された長さ（ミリ秒単位）、および をルーティングしたガーフィールドレビューするための呼び出し

        • Review_trigger string
        • レビュー string

          Reviewer/ Reviewernotes/Prested は OA レビューレコードをミラーリングしています。つまり、人間、そのノート、および が確認した内容の Capped Excern を決定します。

        • Reviewer_notes string
        • run_id string

          RunID は、agent_step にのみ存在するグラフノード呼び出しの識別子です。これは、ノードステップを Node_execution 行に結合する唯一のキーです。

        • span_id string

          SpanID は、このステップを spansコレクション内の完全なトレース詳細に結合します。

        • start_opset_ms integer

          Start OpsetMS は、実行の開始からこのステップの開始までの ミリ秒です。

        • start_at string
        • 状態 string
        • step_number integer

          [] は、割り込みエンドポイントが対象とする値です。グラフ構造を記録し、中断可能なステップがありません。

        • tool_col_id string
        • total_tokens integer

          TotalTokens は解決済みのllmステップにのみ存在します。

        • wait_ms integer
      • 概要 string

        概要は の実行呼び出しメッセージで、サーバー側で切り捨てられます。

      • time_to_first_event_ms integer

        TimeToFirstEventMS は最初のステップのオフセットで、実行にまだステップがない場合は存在しません。

      • total_tokens integer

        TotalTokens は実行の解決されたllmステップを合計するため、実行が実際に費やした金額の下限になります。

      • user_id string

        ユーザー ID と InvoiceUserID は、実行の実行 ID をミラーリングします。委任の対象となるのは として実行された実行と、それを開始したゲートウェイ認証された呼び出し元です。どちらも存在しない場合があります - UE の SessionRun を参照してください。どちらもサポートセーフ ビューから省略されます。

      • wait_ms integer

        WaitMS は、実行の解決済み人間によるレビュー待機であり、実行が一時停止されない場合は存在しません。 ActiveDurationMS では次の待機は除外されます。はどちらも、それらに先行するオーケストレーションエンジンから存在しません。

      • Workspace_id string
    • 切り捨て ブール値

      切り捨てられた では、セッションが 1 回の読み取りで OA が返す行数よりも多くの行があることが報告されているため、これは部分的なビューです。 UE 応答からミラーリングされています。
  • 400

    無効なリクエスト

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 401

    許可されていない

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 500

    内部サーバーエラー

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 502

    バード ゲートウェイ

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
GET /api/v1 /projects/{id}/sessions/{{session_id}/runs 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions/{session_id}/runs' \
 --header "Authorization: $API_KEY"
応答の例（406） 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例（406） 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例（200） 
{
  "count": 42,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": true
}
応答の例（200） 
{
  "count": 42,
  "runs": [
    {
      "active_duration_ms": 42,
      "completion_tokens": 42,
      "duration_ms": 42,
      "error": "string",
      "error_code": "string",
      "execution_id": "string",
      "invoker_user_id": "string",
      "memory_recalls": 42,
      "memory_saves": 42,
      "prompt_tokens": 42,
      "run_number": 42,
      "session_id": "string",
      "slowest_step": {
        "duration_ms": 42.0,
        "kind": "string",
        "name": "string",
        "step_number": 42
      },
      "started_at": "string",
      "startup_failure": {
        "boot_id": "string",
        "code": "string",
        "component": "string",
        "phase": "string",
        "source": "string"
      },
      "status": "string",
      "steps": [
        {
          "completion_tokens": 42,
          "duration_ms": 42.0,
          "error": "string",
          "kind": "string",
          "memory_op": "string",
          "name": "string",
          "presented": "string",
          "presented_truncated": true,
          "prompt_tokens": 42,
          "review_outcome": "string",
          "review_trigger": "string",
          "reviewer": "string",
          "reviewer_notes": "string",
          "run_id": "string",
          "span_id": "string",
          "start_offset_ms": 42,
          "started_at": "string",
          "status": "string",
          "step_number": 42,
          "tool_call_id": "string",
          "total_tokens": 42,
          "wait_ms": 42
        }
      ],
      "summary": "string",
      "time_to_first_event_ms": 42,
      "total_tokens": 42,
      "user_id": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "truncated": true
}
応答の例（400） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（400） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（401） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（401） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（500） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例（502） 
{
  "code": "string",
  "error": "string",
  "success": true
}