세션 나열

얻다 /api/v1/projects/{id}/sessions

프로젝트 의 모든 작업 공간에 걸쳐 지속형 형 대화 세션을 가장 최근에 활성화된 세션부터 나열합니다. 이러한 세션에는 메시지와 실행 실행이 포함됩니다. 예약된 샌드박스 용량 추적 런타임 세션과는 별개입니다. 다음 페이지를 가져오려면 응답에서 Next_cursor를 커서 로 전달합니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID

쿼리 매개변수

limit integer

최대 결과(기본값 50, 최대 200)
Workspace_id 문자열

단일 작업 공간으로 제한
상태 문자열

세션의 최신 실행 상태로 필터링
이후 문자열

이 RFC3339 시간 또는 그 이후에 활동이 있는 세션만
까지 문자열

이 RFC3339 시간 이전에 활동이 있는 세션만
cursor 문자열

이전 응답의 Next_cursor에서 가져온 불투명한 페이징 토큰입니다.

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
200

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- has_more 부울
- limit integer
- Next_cursor 문자열
  
  NextCursor는 이 페이지가 마지막일 때 cursor 쿼리 변수, nil로 다시 전달하는 불투명 토큰입니다. 불투명하므로 이 게이트웨이의 다른 페이징된 엔드포인트가 이미 사용 중인 규칙과 일치하여 클라이언트를 손상시키지 않고 페이징 위치의 형태를 변경할 수 있습니다.
- 세션 배열[객체]
  
  세션 속성 숨기기 세션 속성 표시 객체
  
  active_duration_ms integer
  
  ActiveDurationMS는 각 실행의 경과 시간을 합산하여 세션의 실행 엔드포인트가 보고하는 실행당 지속 시간과 일치하고 턴 사이의 간격을 제외합니다. 이전의 오케스트레이션 엔진 에서 0입니다.
  
  created_at 문자열
  
  first_message_preview 문자열
  
  last_action 문자열
  
  최신 상태 문자열
  
  최신 상태는 세션의 가장 최근 실행 상태입니다.
  
  PROJECT_ID 문자열
  
  session_id 문자열
  
  total_duration_ms integer
  
  TotalDurationMS는 세션의 첫 번째 실행부터 마지막 활동까지의 벽시계 경과 시간이므로 턴 사이의 유휴 시간이 포함됩니다.
  
  total_tokens integer
  
  TotalTokens는 하한값으로, OE를 통해 라우팅된 LLM 호출에 대해 기록된 호출당 수를 합산하고 메모리 추출 토큰은 제외합니다.
  
  전환 integer
  
  user_id 문자열
  
  가시성 문자열
  
  wait_ms integer
  
  WaitMS는 세션 실행 전반에 걸쳐 확정된 인적 검토 대기와 현재 일시 중단된 창 에 지금까지 열려 있는 기간을 합한 값입니다. 이전의 오케스트레이션 엔진 에서 0입니다.
  
  Workspace_id 문자열
- total_count integer
  
  TotalCount는 필터하다 와 일치하는 세션 수입니다. 첫 번째 페이지에만 표시: 카운트하는 것은 모든 일치 항목을 가져오는 것을 의미하며, 이를 피하기 위해 커서 페이징이 존재하며 이동 중에 변경할 수 없습니다.
- 잘린 부울
응답 속성 숨기기 응답 속성 표시 객체
- has_more 부울
- limit integer
- Next_cursor 문자열
  
  NextCursor는 이 페이지가 마지막일 때 cursor 쿼리 변수, nil로 다시 전달하는 불투명 토큰입니다. 불투명하므로 이 게이트웨이의 다른 페이징된 엔드포인트가 이미 사용 중인 규칙과 일치하여 클라이언트를 손상시키지 않고 페이징 위치의 형태를 변경할 수 있습니다.
- 세션 배열[객체]
  
  세션 속성 숨기기 세션 속성 표시 객체
  
  active_duration_ms integer
  
  ActiveDurationMS는 각 실행의 경과 시간을 합산하여 세션의 실행 엔드포인트가 보고하는 실행당 지속 시간과 일치하고 턴 사이의 간격을 제외합니다. 이전의 오케스트레이션 엔진 에서 0입니다.
  
  created_at 문자열
  
  first_message_preview 문자열
  
  last_action 문자열
  
  최신 상태 문자열
  
  최신 상태는 세션의 가장 최근 실행 상태입니다.
  
  PROJECT_ID 문자열
  
  session_id 문자열
  
  total_duration_ms integer
  
  TotalDurationMS는 세션의 첫 번째 실행부터 마지막 활동까지의 벽시계 경과 시간이므로 턴 사이의 유휴 시간이 포함됩니다.
  
  total_tokens integer
  
  TotalTokens는 하한값으로, OE를 통해 라우팅된 LLM 호출에 대해 기록된 호출당 수를 합산하고 메모리 추출 토큰은 제외합니다.
  
  전환 integer
  
  user_id 문자열
  
  가시성 문자열
  
  wait_ms integer
  
  WaitMS는 세션 실행 전반에 걸쳐 확정된 인적 검토 대기와 현재 일시 중단된 창 에 지금까지 열려 있는 기간을 합한 값입니다. 이전의 오케스트레이션 엔진 에서 0입니다.
  
  Workspace_id 문자열
- total_count integer
  
  TotalCount는 필터하다 와 일치하는 세션 수입니다. 첫 번째 페이지에만 표시: 카운트하는 것은 모든 일치 항목을 가져오는 것을 의미하며, 이를 피하기 위해 커서 페이징이 존재하며 이동 중에 변경할 수 없습니다.
- 잘린 부울
400

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
502

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 게이트웨이
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

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
}