Lista de sesiones

OBTENER /api/v1/projects/{id}/sessions
Autorización del portador

Muestra las sesiones de conversación persistentes en todos los espacios de trabajo del proyecto, comenzando por la más reciente. Estas sesiones contienen mensajes y ejecuciones. Son independientes de las sesiones de tiempo de ejecución, que controlan la capacidad reservada del entorno aislado. Para obtener la página siguiente, pase `next_cursor` de la respuesta como cursor.

Parámetros de path

  • ID string Requerido

    ID del proyecto

Parámetros de query

  • limit entero

    Resultados máximos (predeterminado 50, máximo 200)

  • ID del espacio de trabajo string

    Restringir a un único espacio de trabajo

  • Estado string

    Filtrar por el estado de ejecución más reciente de la sesión.

  • ya que string

    Solo sesiones con actividad en o después de este tiempo RFC3339

  • hasta string

    Solo sesiones con actividad anterior a este tiempo RFC3339

  • cursor string

    Token de paginación opaco del next_cursor de una respuesta anterior

Respuestas

  • 406

    Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    OK

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • tiene_más booleano
    • limit entero
    • siguiente_cursor string

      NextCursor es un token opaco que se devuelve como parámetro de consulta cursor, y es nulo cuando esta página es la última. Es opaco para que la posición de paginación pueda cambiar sin afectar a los clientes, siguiendo la convención que ya utilizan los demás puntos finales paginados de esta puerta de enlace.

    • Sesiones arreglo[objeto]
      Ocultar atributos de sesión Mostrar atributos de las sesiones Objeto
      • duración_activa_ms entero

        ActiveDurationMS suma el tiempo transcurrido de cada ejecución, por lo que coincide con las duraciones por ejecución que informa el punto final de ejecuciones de la sesión y excluye los intervalos entre turnos. Cero de un motor de orquestación anterior.

      • created_at string
      • vista previa del primer mensaje string
      • última_actividad string
      • estado_más_último string

        LatestStatus es el estado de la ejecución más reciente de la sesión.

      • project_id string
      • session_id string
      • duración_total_ms entero

        TotalDurationMS es el tiempo transcurrido en tiempo real desde la primera ejecución de la sesión hasta su última actividad, por lo que incluye el tiempo de inactividad entre turnos.

      • total_tokens entero

        TotalTokens es un límite inferior: suma los recuentos por llamada registrados para las llamadas LLM enrutadas a través del OE y excluye los tokens de extracción de memoria.

      • vueltas entero
      • user_id string
      • visibilidad string
      • esperar_ms entero

        WaitMS suma el tiempo de espera de revisión humana resuelto en todas las ejecuciones de la sesión, más la ventana abierta hasta el momento en una sesión actualmente suspendida. Cero para un motor de orquestación anterior.

      • ID del espacio de trabajo string
    • recuento_total entero

      TotalCount es el número de sesiones que coinciden con el filtro. Solo aparece en la primera página: contarlo implica obtener todas las coincidencias, que es precisamente lo que la paginación del cursor pretende evitar, y no puede cambiar durante el recorrido.

    • truncado booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • tiene_más booleano
    • limit entero
    • siguiente_cursor string

      NextCursor es un token opaco que se devuelve como parámetro de consulta cursor, y es nulo cuando esta página es la última. Es opaco para que la posición de paginación pueda cambiar sin afectar a los clientes, siguiendo la convención que ya utilizan los demás puntos finales paginados de esta puerta de enlace.

    • Sesiones arreglo[objeto]
      Ocultar atributos de sesión Mostrar atributos de las sesiones Objeto
      • duración_activa_ms entero

        ActiveDurationMS suma el tiempo transcurrido de cada ejecución, por lo que coincide con las duraciones por ejecución que informa el punto final de ejecuciones de la sesión y excluye los intervalos entre turnos. Cero de un motor de orquestación anterior.

      • created_at string
      • vista previa del primer mensaje string
      • última_actividad string
      • estado_más_último string

        LatestStatus es el estado de la ejecución más reciente de la sesión.

      • project_id string
      • session_id string
      • duración_total_ms entero

        TotalDurationMS es el tiempo transcurrido en tiempo real desde la primera ejecución de la sesión hasta su última actividad, por lo que incluye el tiempo de inactividad entre turnos.

      • total_tokens entero

        TotalTokens es un límite inferior: suma los recuentos por llamada registrados para las llamadas LLM enrutadas a través del OE y excluye los tokens de extracción de memoria.

      • vueltas entero
      • user_id string
      • visibilidad string
      • esperar_ms entero

        WaitMS suma el tiempo de espera de revisión humana resuelto en todas las ejecuciones de la sesión, más la ventana abierta hasta el momento en una sesión actualmente suspendida. Cero para un motor de orquestación anterior.

      • ID del espacio de trabajo string
    • recuento_total entero

      TotalCount es el número de sesiones que coinciden con el filtro. Solo aparece en la primera página: contarlo implica obtener todas las coincidencias, que es precisamente lo que la paginación del cursor pretende evitar, y no puede cambiar durante el recorrido.

    • truncado booleano
  • 400

    Solicitud incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 401

    No autorizado

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno del servidor

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 502

    Puerta de enlace incorrecta

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
GET /api/v1/projects/{id}/sessions 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions' \
 --header "Authorization: $API_KEY"
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (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
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}