Obtener mensajes de sesión

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

Obtiene todos los mensajes de una sesión específica a través del motor de orquestación del espacio de trabajo. El ámbito del proyecto se define mediante el parámetro de ruta id, y la organización se deriva de dicho proyecto.

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

    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
    • history_status string

      HistoryStatus informa si Messages es una fuente autorizada o si aún se encuentra en fase de preparación.

    • estado_más_último string

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

    • mensajes arreglo[objeto]
      Ocultar atributos de mensajes Mostrar atributos de los mensajes Objeto
      • argumentos_con_palabras_adicionales Objeto

        Se permiten propiedades adicionales.

      • Contenido string
      • ID string
      • Nombre string

        Nombre de la herramienta para los mensajes de la herramienta

      • rol string
      • session_id string
      • Marca de tiempo string
      • ID de llamada de herramienta string
      • llamadas_de_herramientas arreglo[objeto]
        Ocultar atributos de llamadas a herramientas Mostrar atributos de llamadas a herramientas Objeto
        • ID string
        • index entero
        • Nombre string
        • tipo string
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • history_status string

      HistoryStatus informa si Messages es una fuente autorizada o si aún se encuentra en fase de preparación.

    • estado_más_último string

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

    • mensajes arreglo[objeto]
      Ocultar atributos de mensajes Mostrar atributos de los mensajes Objeto
      • argumentos_con_palabras_adicionales Objeto

        Se permiten propiedades adicionales.

      • Contenido string
      • ID string
      • Nombre string

        Nombre de la herramienta para los mensajes de la herramienta

      • rol string
      • session_id string
      • Marca de tiempo string
      • ID de llamada de herramienta string
      • llamadas_de_herramientas arreglo[objeto]
        Ocultar atributos de llamadas a herramientas Mostrar atributos de llamadas a herramientas Objeto
        • ID string
        • index entero
        • Nombre string
        • tipo string
  • 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
  • 422

    PROJECT_SECRET_INVALID: el espacio de trabajo no se puede iniciar porque un secreto de proyecto no es válido o es inaccesible (corrija el secreto y vuelva a implementar).

    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/{session_id}/messages 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions/{session_id}/messages' \
 --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) 
{
  "history_status": "string",
  "latest_status": "string",
  "messages": [
    {
      "additional_kwargs": {},
      "content": "string",
      "id": "string",
      "name": "string",
      "role": "string",
      "session_id": "string",
      "timestamp": "string",
      "tool_call_id": "string",
      "tool_calls": [
        {
          "id": "string",
          "index": 42,
          "name": "string",
          "type": "string"
        }
      ]
    }
  ]
}
Ejemplos de respuesta (200) 
{
  "history_status": "string",
  "latest_status": "string",
  "messages": [
    {
      "additional_kwargs": {},
      "content": "string",
      "id": "string",
      "name": "string",
      "role": "string",
      "session_id": "string",
      "timestamp": "string",
      "tool_call_id": "string",
      "tool_calls": [
        {
          "id": "string",
          "index": 42,
          "name": "string",
          "type": "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 (422) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (422) 
{
  "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
}