Obtén una sesión de carreras

OBTENER /api/v1/projects/{id}/sessions/{session_id}/runs

Devuelve las ejecuciones de la sesión, de la más antigua a la más antigua, con sus pasos en orden. Cada paso incluye su tipo, desplazamiento inicial dentro de la ejecución, duración, número de tokens, estado y número de paso.

Parámetros de path

ID string Requerido

ID del proyecto
session_id string Requerido

ID de sesión

Parámetros de query

ID del espacio de trabajo string

ID de espacio de trabajo para la resolución del espacio de trabajo

Respuestas

406

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

aplicación/vnd.agent-engine-2026-09-20-preview+json

aplicación/vnd.agent-engine-2026-09-20-preview+json application/json

OK
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- count entero
- carreras arreglo[objeto]
  
  Ocultar atributos de carreras Atributos de la serie de espectáculos Objeto
  
  duración_activa_ms entero
  
  tokens de finalización entero
  
  duración_ms entero
  
  DurationMS es el tiempo transcurrido desde el inicio de la ejecución hasta su última actualización.
  
  Error string
  
  error_code string
  
  id_de_ejecución string
  
  invoker_user_id string
  
  recuerdos entero
  
  MemoryRecalls y MemorySaves contabilizan los pasos de memoria establecidos, un límite inferior para una lectura truncada.
  
  guardado_de_memoria entero
  
  prompt_tokens entero
  
  PromptTokens y CompletionTokens dividen TotalTokens. Ambos están ausentes cuando la ejecución no tiene un paso llm resuelto.
  
  número_de_ejecución entero
  
  RunNumber es la posición de la ejecución en la sesión, basada en 1, de la más antigua a la más reciente. Cuando truncated es verdadero, es relativo a la ventana devuelta: las ejecuciones más antiguas son las que se descartan al alcanzar el límite, por lo que la ejecución 1 no es la primera de la sesión.
  
  session_id string
  
  slowest_step Objeto
  
  SlowestStep no está presente cuando la carrera no tiene un paso establecido.
  
  Ocultar atributos slowest_step Mostrar atributos de paso más lento Objeto
  
  duración_ms Número
  
  kind string
  
  Nombre string
  
  número_de_paso entero
  
  comenzó_en string
  
  fallo_de_inicio Objeto
  
  Ocultar atributos startup_failure Mostrar atributos de startup_failure Objeto
  
  id_de_arranque string
  
  Código string
  
  componente string
  
  fase string
  
  Origen string
  
  Estado string
  
  pasos arreglo[objeto]
  
  Ocultar atributos de pasos Mostrar atributos de los pasos Objeto
  
  tokens de finalización entero
  
  duración_ms Número
  
  DurationMS no está disponible para un paso que aún no se ha resuelto.
  
  Error string
  
  kind string
  
  El tipo es la categoría del paso: llm, herramienta, memoria, guardabarrera, política, a2a o agent_step.
  
  operación_de_memoria string
  
  MemoryOp es "recuperar" o "guardar" en un paso de memoria establecido, a menos que exista otro caso.
  
  Nombre string
  
  presentado string
  
  presentado_truncado booleano
  
  prompt_tokens entero
  
  PromptTokens y CompletionTokens dividen TotalTokens, ambos presentes solo en un paso llm resuelto.
  
  review_outcome string
  
  ReviewOutcome, WaitMS y ReviewTrigger solo están presentes en los pasos de revisión humana: el estado de la espera ("pendiente", luego "aprobado"/"rechazado"), su duración establecida en ms (ausente mientras está pendiente) y la barrera de seguridad que enrutó la llamada a revisión.
  
  disparador de revisión string
  
  crítico string
  
  El revisor/notas del revisor/presentado reflejan el registro de revisión de OE: la persona que tomó la decisión, su nota y un extracto con límite de lo que revisó.
  
  notas_del_revisor string
  
  run_id string
  
  RunID es el identificador de la invocación del nodo del gráfico, presente únicamente en agent_step. Es la única clave que vincula un paso de nodo con su fila node_executions.
  
  span_id string
  
  SpanID une este paso a su detalle de traza completa en la colección de tramos.
  
  start_offset_ms entero
  
  StartOffsetMS son los milisegundos que transcurren desde el inicio de la ejecución hasta el inicio de este paso.
  
  comenzó_en string
  
  Estado string
  
  número_de_paso entero
  
  StepNumber es el valor al que apunta el punto final de interrupción. No está presente en agent_step, que registra la estructura del gráfico y no tiene ningún paso interrumpible.
  
  ID de llamada de herramienta string
  
  total_tokens entero
  
  TotalTokens solo está presente en los pasos llm liquidados.
  
  esperar_ms entero
  
  Resumen string
  
  El resumen es el mensaje que invoca la ejecución, truncado en el servidor.
  
  tiempo_hasta_el_primer_evento_ms entero
  
  TimeToFirstEventMS es el desplazamiento del primer paso, ausente cuando la ejecución aún no tiene pasos.
  
  total_tokens entero
  
  TotalTokens suma los pasos llm resueltos de la ejecución, por lo que es un límite inferior de lo que realmente se gastó en la ejecución.
  
  user_id string
  
  UserID e InvokerUserID reflejan la identidad de ejecución de la operación: el destino de la delegación con el que se ejecutó la operación y el llamador autenticado por la puerta de enlace que la inició. Cualquiera de ellos puede estar ausente; consulte SessionRun del OE. Ambos se omiten en la vista segura para soporte.
  
  esperar_ms entero
  
  WaitMS es el tiempo de espera de revisión humana establecido para la ejecución, ausente cuando la ejecución nunca se suspende. ActiveDurationMS excluye ese tiempo de espera; ambos están ausentes en un motor de orquestación anterior a ellos.
  
  ID del espacio de trabajo string
- truncado booleano
  
  Los informes truncados indican que la sesión contenía más filas de las que devuelve OE en una sola lectura, por lo que se trata de una vista parcial. Reflejado de la respuesta de OE.
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- count entero
- carreras arreglo[objeto]
  
  Ocultar atributos de carreras Atributos de la serie de espectáculos Objeto
  
  duración_activa_ms entero
  
  tokens de finalización entero
  
  duración_ms entero
  
  DurationMS es el tiempo transcurrido desde el inicio de la ejecución hasta su última actualización.
  
  Error string
  
  error_code string
  
  id_de_ejecución string
  
  invoker_user_id string
  
  recuerdos entero
  
  MemoryRecalls y MemorySaves contabilizan los pasos de memoria establecidos, un límite inferior para una lectura truncada.
  
  guardado_de_memoria entero
  
  prompt_tokens entero
  
  PromptTokens y CompletionTokens dividen TotalTokens. Ambos están ausentes cuando la ejecución no tiene un paso llm resuelto.
  
  número_de_ejecución entero
  
  RunNumber es la posición de la ejecución en la sesión, basada en 1, de la más antigua a la más reciente. Cuando truncated es verdadero, es relativo a la ventana devuelta: las ejecuciones más antiguas son las que se descartan al alcanzar el límite, por lo que la ejecución 1 no es la primera de la sesión.
  
  session_id string
  
  slowest_step Objeto
  
  SlowestStep no está presente cuando la carrera no tiene un paso establecido.
  
  Ocultar atributos slowest_step Mostrar atributos de paso más lento Objeto
  
  duración_ms Número
  
  kind string
  
  Nombre string
  
  número_de_paso entero
  
  comenzó_en string
  
  fallo_de_inicio Objeto
  
  Ocultar atributos startup_failure Mostrar atributos de startup_failure Objeto
  
  id_de_arranque string
  
  Código string
  
  componente string
  
  fase string
  
  Origen string
  
  Estado string
  
  pasos arreglo[objeto]
  
  Ocultar atributos de pasos Mostrar atributos de los pasos Objeto
  
  tokens de finalización entero
  
  duración_ms Número
  
  DurationMS no está disponible para un paso que aún no se ha resuelto.
  
  Error string
  
  kind string
  
  El tipo es la categoría del paso: llm, herramienta, memoria, guardabarrera, política, a2a o agent_step.
  
  operación_de_memoria string
  
  MemoryOp es "recuperar" o "guardar" en un paso de memoria establecido, a menos que exista otro caso.
  
  Nombre string
  
  presentado string
  
  presentado_truncado booleano
  
  prompt_tokens entero
  
  PromptTokens y CompletionTokens dividen TotalTokens, ambos presentes solo en un paso llm resuelto.
  
  review_outcome string
  
  ReviewOutcome, WaitMS y ReviewTrigger solo están presentes en los pasos de revisión humana: el estado de la espera ("pendiente", luego "aprobado"/"rechazado"), su duración establecida en ms (ausente mientras está pendiente) y la barrera de seguridad que enrutó la llamada a revisión.
  
  disparador de revisión string
  
  crítico string
  
  El revisor/notas del revisor/presentado reflejan el registro de revisión de OE: la persona que tomó la decisión, su nota y un extracto con límite de lo que revisó.
  
  notas_del_revisor string
  
  run_id string
  
  RunID es el identificador de la invocación del nodo del gráfico, presente únicamente en agent_step. Es la única clave que vincula un paso de nodo con su fila node_executions.
  
  span_id string
  
  SpanID une este paso a su detalle de traza completa en la colección de tramos.
  
  start_offset_ms entero
  
  StartOffsetMS son los milisegundos que transcurren desde el inicio de la ejecución hasta el inicio de este paso.
  
  comenzó_en string
  
  Estado string
  
  número_de_paso entero
  
  StepNumber es el valor al que apunta el punto final de interrupción. No está presente en agent_step, que registra la estructura del gráfico y no tiene ningún paso interrumpible.
  
  ID de llamada de herramienta string
  
  total_tokens entero
  
  TotalTokens solo está presente en los pasos llm liquidados.
  
  esperar_ms entero
  
  Resumen string
  
  El resumen es el mensaje que invoca la ejecución, truncado en el servidor.
  
  tiempo_hasta_el_primer_evento_ms entero
  
  TimeToFirstEventMS es el desplazamiento del primer paso, ausente cuando la ejecución aún no tiene pasos.
  
  total_tokens entero
  
  TotalTokens suma los pasos llm resueltos de la ejecución, por lo que es un límite inferior de lo que realmente se gastó en la ejecución.
  
  user_id string
  
  UserID e InvokerUserID reflejan la identidad de ejecución de la operación: el destino de la delegación con el que se ejecutó la operación y el llamador autenticado por la puerta de enlace que la inició. Cualquiera de ellos puede estar ausente; consulte SessionRun del OE. Ambos se omiten en la vista segura para soporte.
  
  esperar_ms entero
  
  WaitMS es el tiempo de espera de revisión humana establecido para la ejecución, ausente cuando la ejecución nunca se suspende. ActiveDurationMS excluye ese tiempo de espera; ambos están ausentes en un motor de orquestación anterior a ellos.
  
  ID del espacio de trabajo string
- truncado booleano
  
  Los informes truncados indican que la sesión contenía más filas de las que devuelve OE en una sola lectura, por lo que se trata de una vista parcial. Reflejado de la respuesta de OE.
400

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

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/{session_id}/runs

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

{
  "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
}

Ejemplos de respuesta (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
}

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
}