セッションを一覧表示する

GET /api/v1/projects/{id}/sessions

プロジェクト内のすべてのワークスペースにわたる永続的な通信セッションを、最新アクティブなものが先頭で一覧表示します。これらのセッションには、メッセージと実行が含まれます。これらは予約されたサンドボックスキャパシティーを追跡するランタイムセッションとは別です。次のページを取得するには、レスポンスから next_cursor をカーソルとして渡します。

path パラメータ

id string 必須

プロジェクトID

クエリパラメータ

limit integer

最大結果（デフォルト50、最大 200）
Workspace_id string

単一のワークスペースに制限する
状態 string

セッションの最新の実行状態でフィルタリング
以来 string

この RFC3339 時間以降にアクティビティがあるセッションのみ
まで string

この RFC3339 時間より前にアクティビティがあるセッションのみ
cursor string

前の応答の next_cursor からの遅延ページングトークン

応答

406

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

サポートされていない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

アプリケーション/vnd.agent- engine-2026-09-20-preview+json

アプリケーション/vnd.agent- engine-2026-09-20-preview+json application/ JSON

OK
応答属性の非表示応答属性の表示オブジェクト
- has_more ブール値
- limit integer
- 次の_カーソル string
  
  NextCursor は、このページが最後のときに nil として cursor クエリパラメータとして渡すための opaque トークンです。不整合があるため、クライアントを中断することなくページング位置の形状を変更できます。これは、このゲートウェイの他のページ付きエンドポイントがすでに使用している規則と一致します。
- セッション array[オブジェクト]
  
  セッション属性を非表示にするセッション属性の表示オブジェクト
  
  Active_ duration_ms integer
  
  ActiveDurationMS は各実行の独自の経過時間を合計するため、セッションの実行エンドポイントが報告する実行ごとの期間と一致し、ビルド間の差は除外されます。先行するオーケストレーションエンジンからのゼロ。
  
  created_at string
  
  first_message_preview string
  
  last_active string
  
  latest_status string
  
  latestStatus は、セッションの最新の実行ステータスです。
  
  project_id string
  
  Session_id string
  
  total_ duration_ms integer
  
  TotalDurationMS は、セッションの最初の実行から最後のアクティビティまでのウォールクロック経過時間であるため、タームと化の間にアイドル時間が含まれます。
  
  total_tokens integer
  
  TotalTokens は下限値を下限とします。これは UE を介してルーティングされた LVM 呼び出しで記録された呼び出しごとのカウントを合計し、メモリ抽出トークンを除外します。
  
  オフ integer
  
  user_id string
  
  可視性 string
  
  wait_ms integer
  
  WaitMS は、セッションの実行全体で解決された人間によるレビューの待機時間と、現在一時停止されているセッションでそれまでに開いたウィンドウの合計数です。先行するオーケストレーションエンジンからのゼロ。
  
  Workspace_id string
- total_count integer
  
  TotalCount は、フィルターに一致するセッションの数です。最初のページにのみ表示されます。カウントすると、すべての一致を取得することを意味します。これは、カーソルページングが存在するのを回避するために存在し、ウォークスルーを変更することはできません。
- 切り捨てブール値
応答属性の非表示応答属性の表示オブジェクト
- has_more ブール値
- limit integer
- 次の_カーソル string
  
  NextCursor は、このページが最後のときに nil として cursor クエリパラメータとして渡すための opaque トークンです。不整合があるため、クライアントを中断することなくページング位置の形状を変更できます。これは、このゲートウェイの他のページ付きエンドポイントがすでに使用している規則と一致します。
- セッション array[オブジェクト]
  
  セッション属性を非表示にするセッション属性の表示オブジェクト
  
  Active_ duration_ms integer
  
  ActiveDurationMS は各実行の独自の経過時間を合計するため、セッションの実行エンドポイントが報告する実行ごとの期間と一致し、ビルド間の差は除外されます。先行するオーケストレーションエンジンからのゼロ。
  
  created_at string
  
  first_message_preview string
  
  last_active string
  
  latest_status string
  
  latestStatus は、セッションの最新の実行ステータスです。
  
  project_id string
  
  Session_id string
  
  total_ duration_ms integer
  
  TotalDurationMS は、セッションの最初の実行から最後のアクティビティまでのウォールクロック経過時間であるため、タームと化の間にアイドル時間が含まれます。
  
  total_tokens integer
  
  TotalTokens は下限値を下限とします。これは UE を介してルーティングされた LVM 呼び出しで記録された呼び出しごとのカウントを合計し、メモリ抽出トークンを除外します。
  
  オフ integer
  
  user_id string
  
  可視性 string
  
  wait_ms integer
  
  WaitMS は、セッションの実行全体で解決された人間によるレビューの待機時間と、現在一時停止されているセッションでそれまでに開いたウィンドウの合計数です。先行するオーケストレーションエンジンからのゼロ。
  
  Workspace_id string
- total_count integer
  
  TotalCount は、フィルターに一致するセッションの数です。最初のページにのみ表示されます。カウントすると、すべての一致を取得することを意味します。これは、カーソルページングが存在するのを回避するために存在し、ウォークスルーを変更することはできません。
- 切り捨てブール値
400

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

無効なリクエスト
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
401

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

許可されていない
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
500

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

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

application/ JSON

application/ JSON アプリケーション/vnd.agent- engine-2026-09-20-preview+json

バードゲートウェイ
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値
応答属性の非表示応答属性の表示オブジェクト
- コード string
- エラー string
- 成功ブール値

GET /api/v1 /projects/{id}/sessions

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions' \
 --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）

{
  "has_more": true,
  "limit": 42,
  "next_cursor": "string",
  "sessions": [
    {
      "active_duration_ms": 42,
      "created_at": "string",
      "first_message_preview": "string",
      "last_activity": "string",
      "latest_status": "string",
      "project_id": "string",
      "session_id": "string",
      "total_duration_ms": 42,
      "total_tokens": 42,
      "turns": 42,
      "user_id": "string",
      "visibility": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "total_count": 42,
  "truncated": true
}

応答の例（200）

{
  "has_more": true,
  "limit": 42,
  "next_cursor": "string",
  "sessions": [
    {
      "active_duration_ms": 42,
      "created_at": "string",
      "first_message_preview": "string",
      "last_activity": "string",
      "latest_status": "string",
      "project_id": "string",
      "session_id": "string",
      "total_duration_ms": 42,
      "total_tokens": 42,
      "turns": 42,
      "user_id": "string",
      "visibility": "string",
      "wait_ms": 42,
      "workspace_id": "string"
    }
  ],
  "total_count": 42,
  "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
}

セッションを一覧表示する

path パラメータ

クエリ パラメータ

応答

クエリパラメータ