Listar sesiones de tiempo de ejecución

OBTENER /api/v1/projects/{id}/workspaces/{workspace_id}/runtime-sessions

Enumera las sesiones de tiempo de ejecución que reservan capacidad de sandbox de agente o herramienta para el espacio de trabajo, incluidas las sesiones que aún liberan capacidad. Las sesiones de tiempo de ejecución son independientes de las sesiones de conversación duraderas, que almacenan el historial de la conversación. El estado es activo mientras la sesión mantiene capacidad y se detiene mientras la liberación está en curso. last_activity_at y scheduled_release_at siguen el tiempo de espera de inactividad del espacio de trabajo. scheduled_release_at se omite mientras un componente aún está liberando. is_test_session identifica las sesiones de prueba de Playground y CLI. La lista está vacía cuando no hay capacidad de tiempo de ejecución reservada. Una detención aceptada o una liberación no confirmada permanece visible después de un reinicio y desde cada réplica de tiempo de ejecución. Las solicitudes de lista concurrentes comparten una actualización de estado del ejecutor. Una actualización exitosa se reutiliza durante aproximadamente un segundo. Si la actualización de dos segundos falla o devuelve datos incompletos, el punto final utiliza la instantánea en caché de la réplica actual. last_activity_at utiliza el reloj de la réplica servidora.

Parámetros de path

  • ID string Requerido

    ID del proyecto

  • ID del espacio de trabajo string Requerido

    ID del espacio de trabajo

Respuestas

  • 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 atributo de respuesta Mostrar atributo de respuesta Objeto
    • Sesiones arreglo[objeto]
      Ocultar atributos de sesión Mostrar atributos de las sesiones Objeto
      • is_test_session booleano
      • última_actividad_en string
      • lanzamiento_programado_en string
      • session_id string
      • Estado string
    Ocultar atributo de respuesta Mostrar atributo de respuesta Objeto
    • Sesiones arreglo[objeto]
      Ocultar atributos de sesión Mostrar atributos de las sesiones Objeto
      • is_test_session booleano
      • última_actividad_en string
      • lanzamiento_programado_en string
      • session_id string
      • Estado string
  • 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
  • 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
  • Forbidden

    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
  • No encontrado

    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
  • 425

    El motor de orquestación del espacio de trabajo no está listo.

    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
  • 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
  • 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}/workspaces/{workspace_id}/runtime-sessions
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/runtime-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)
{
  "sessions": [
    {
      "is_test_session": true,
      "last_activity_at": "string",
      "scheduled_release_at": "string",
      "session_id": "string",
      "status": "string"
    }
  ]
}
Ejemplos de respuesta (200)
{
  "sessions": [
    {
      "is_test_session": true,
      "last_activity_at": "string",
      "scheduled_release_at": "string",
      "session_id": "string",
      "status": "string"
    }
  ]
}
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 (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (425)
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (425)
{
  "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
}