Obter execuções de uma sessão

OBTER /api/v1/projects/{id}/sessions/{session_id}/runs
Autenticação do portador

Retorna as execuções mais antigas da sessão, cada uma com suas etapas em ordem. Uma etapa carrega seu tipo, deslocamento inicial dentro da execução, duração, contagem de tokens, status e step_number.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

  • session_id string Obrigatório

    ID da sessão

parâmetros de query

  • workspace_id string

    ID do workspace para a resolução do workspace

Respostas

  • 406

    Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes de validação opcionais definidos pelo esquema de erro padrão; Os erros de negociação da API não emitem este campo.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Campos com falhas de validação.

        Ocultar atributos de campos Mostrar atributos dos campos objeto

        Um campo e sua falha de validação.

        • Descrição string Obrigatório

          Falha na validação legível por humanos.

        • Campo string Obrigatório

          Nome ou caminho do campo de solicitação inválido .

    • detalhe string Obrigatório

      Detalhes de erro legíveis por humanos.

    • Erro inteiro Obrigatório

      HTTP status code.

    • Código de erro string Obrigatório

      Código de erro legível por máquina.

    • Parâmetros array[string]

      Solicitar nomes de parâmetros associados ao erro; omitido quando nenhum se aplica.

    • Razão string Obrigatório

      Frase de razão do status HTTP.
  • 200

    OK

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • contar inteiro
    • corre array[objeto]
      Ocultar atributos de execuções Mostrar atributos de execuções objeto
      • Active_duration_ms inteiro
      • completed_tokens inteiro
      • duration_ms inteiro

        DurationMS é o tempo de relógio de parede desde o início da execução até sua última atualização.

      • Erro string
      • error_code string
      • execution_id string
      • invoker_user_id string
      • memory_recalls inteiro

        MemoryRecalls e MemorySves contam as etapas de memória estabelecidas, um limite inferior em uma leitura truncada.

      • memory_sves inteiro
      • prompt_tokens inteiro

        PromptTokens e CompletionTokens divisão TotalTokens. Ambos ausentes quando a execução não tem passo de llm definido.

      • run_number inteiro

        RunNumber é a posição baseada em 1 da execução na sessão, o mais antigo primeiro. Quando truncado é verdadeiro, ele é relativo à janela retornada: as execuções mais antigas são as descartadas no limite, então a execução 1 não é a primeira da sessão.

      • session_id string
      • slowest_step objeto

        SlowestStep está ausente quando a execução não tem etapa estabelecida.

        Ocultar atributos slowest_step Mostrar atributos de slowest_step objeto
        • duration_ms número
        • kind string
        • name string
        • step_number inteiro
      • started_at string
      • startup_failure objeto
        Ocultar atributos startup_failure Mostrar atributos startup_failure objeto
        • inicialização_id string
        • código string
        • componente string
        • fase string
        • Fonte string
      • Status string
      • passos array[objeto]
        Ocultar atributos das etapas Mostrar atributos de etapas objeto
        • completed_tokens inteiro
        • duration_ms número

          DurationMS está ausente em uma etapa que ainda não foi resolvida.

        • Erro string
        • kind string

          Tipo é a categoria da etapa: llm, ferramenta, memória, guardrail, política, a2a ou Agent_step.

        • memory_op string

          MemoryOp é "recall" ou "salvar" em uma etapa de memória estabelecida, ausente de outra forma.

        • name string
        • apresentado string
        • Apresentado_truncated booleano
        • prompt_tokens inteiro

          PromptTokens e CompletionTokens divisão TotalTokens, ambos presentes apenas em uma etapa llm estabelecida.

        • review_outcome string

          ReviewOutcome, WaitMS e ReviewTrigger estão presentes somente em etapas de humanos_reviews: o estado de espera ("pendente", depois "aprovado"/"rejeitado"), seu comprimento determinado em ms (ausente enquanto pendente) e a grade de proteção que encaminhava o ligue para a revisão.

        • revisão_trigger string
        • crítico string

          Reviewer/ReviewerNotes/Presented espelha o registro de revisão do OE: decidir o ser humano, sua nota e um trecho limitado do que revisaram.

        • writeer_notes string
        • run_id string

          RunID é o identificador de invocação do nó de gráfico, presente somente em Agent_step. É a única chave que vincula uma etapa de nó à sua linha node_executions.

        • span_id string

          O EspanID associa esta etapa aos detalhes de rastreamento completos na coleção spans.

        • start_offset_ms inteiro

          StartOffsetMS é milissegundos do início da execução até o início desta etapa.

        • started_at string
        • Status string
        • step_number inteiro

          StepNumber é o valor que o endpoint de interrupção visa. Ausente em Agent_step, que registra a estrutura do gráfico e não tem etapa interrompível.

        • tool_call_id string
        • total_tokens inteiro

          O TotalTokens está presente apenas em etapas llm definidas.

        • wait_ms inteiro
      • Resumo string

        Resumo é a mensagem de invocação da execução, truncada no lado do servidor.

      • time_to_first_event_ms inteiro

        TimeToFirstEventMS é o deslocamento da primeira etapa, ausente quando a execução ainda não tem etapas.

      • total_tokens inteiro

        O TotalTokens soma as etapas de llm estabelecidas da execução, portanto, é um limite inferior do que a execução realmente gastou.

      • user_id string

        UserID e InvokerUserID espelham a identidade de execução da execução: a delegação tem como alvo a execução executada e o chamador autenticado pelo gateway que a iniciou. Qualquer um pode estar ausente - consulte o SessionRun do OE. Ambos são omitidos da exibição segura de suporte.

      • wait_ms inteiro

        WaitMS é a espera de revisão humana resolvida da execução, ausente quando a execução nunca é suspensa. ActiveDurationMS exclui essa espera; ambos ausentes de um mecanismo de orquestração que os antecede.

      • workspace_id string
    • truncado booleano

      Relatórios truncados de que a sessão tinha mais linhas do que o OE retorna em uma leitura, então esta é uma visualização parcial. Espelhado da resposta do OE.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • contar inteiro
    • corre array[objeto]
      Ocultar atributos de execuções Mostrar atributos de execuções objeto
      • Active_duration_ms inteiro
      • completed_tokens inteiro
      • duration_ms inteiro

        DurationMS é o tempo de relógio de parede desde o início da execução até sua última atualização.

      • Erro string
      • error_code string
      • execution_id string
      • invoker_user_id string
      • memory_recalls inteiro

        MemoryRecalls e MemorySves contam as etapas de memória estabelecidas, um limite inferior em uma leitura truncada.

      • memory_sves inteiro
      • prompt_tokens inteiro

        PromptTokens e CompletionTokens divisão TotalTokens. Ambos ausentes quando a execução não tem passo de llm definido.

      • run_number inteiro

        RunNumber é a posição baseada em 1 da execução na sessão, o mais antigo primeiro. Quando truncado é verdadeiro, ele é relativo à janela retornada: as execuções mais antigas são as descartadas no limite, então a execução 1 não é a primeira da sessão.

      • session_id string
      • slowest_step objeto

        SlowestStep está ausente quando a execução não tem etapa estabelecida.

        Ocultar atributos slowest_step Mostrar atributos de slowest_step objeto
        • duration_ms número
        • kind string
        • name string
        • step_number inteiro
      • started_at string
      • startup_failure objeto
        Ocultar atributos startup_failure Mostrar atributos startup_failure objeto
        • inicialização_id string
        • código string
        • componente string
        • fase string
        • Fonte string
      • Status string
      • passos array[objeto]
        Ocultar atributos das etapas Mostrar atributos de etapas objeto
        • completed_tokens inteiro
        • duration_ms número

          DurationMS está ausente em uma etapa que ainda não foi resolvida.

        • Erro string
        • kind string

          Tipo é a categoria da etapa: llm, ferramenta, memória, guardrail, política, a2a ou Agent_step.

        • memory_op string

          MemoryOp é "recall" ou "salvar" em uma etapa de memória estabelecida, ausente de outra forma.

        • name string
        • apresentado string
        • Apresentado_truncated booleano
        • prompt_tokens inteiro

          PromptTokens e CompletionTokens divisão TotalTokens, ambos presentes apenas em uma etapa llm estabelecida.

        • review_outcome string

          ReviewOutcome, WaitMS e ReviewTrigger estão presentes somente em etapas de humanos_reviews: o estado de espera ("pendente", depois "aprovado"/"rejeitado"), seu comprimento determinado em ms (ausente enquanto pendente) e a grade de proteção que encaminhava o ligue para a revisão.

        • revisão_trigger string
        • crítico string

          Reviewer/ReviewerNotes/Presented espelha o registro de revisão do OE: decidir o ser humano, sua nota e um trecho limitado do que revisaram.

        • writeer_notes string
        • run_id string

          RunID é o identificador de invocação do nó de gráfico, presente somente em Agent_step. É a única chave que vincula uma etapa de nó à sua linha node_executions.

        • span_id string

          O EspanID associa esta etapa aos detalhes de rastreamento completos na coleção spans.

        • start_offset_ms inteiro

          StartOffsetMS é milissegundos do início da execução até o início desta etapa.

        • started_at string
        • Status string
        • step_number inteiro

          StepNumber é o valor que o endpoint de interrupção visa. Ausente em Agent_step, que registra a estrutura do gráfico e não tem etapa interrompível.

        • tool_call_id string
        • total_tokens inteiro

          O TotalTokens está presente apenas em etapas llm definidas.

        • wait_ms inteiro
      • Resumo string

        Resumo é a mensagem de invocação da execução, truncada no lado do servidor.

      • time_to_first_event_ms inteiro

        TimeToFirstEventMS é o deslocamento da primeira etapa, ausente quando a execução ainda não tem etapas.

      • total_tokens inteiro

        O TotalTokens soma as etapas de llm estabelecidas da execução, portanto, é um limite inferior do que a execução realmente gastou.

      • user_id string

        UserID e InvokerUserID espelham a identidade de execução da execução: a delegação tem como alvo a execução executada e o chamador autenticado pelo gateway que a iniciou. Qualquer um pode estar ausente - consulte o SessionRun do OE. Ambos são omitidos da exibição segura de suporte.

      • wait_ms inteiro

        WaitMS é a espera de revisão humana resolvida da execução, ausente quando a execução nunca é suspensa. ActiveDurationMS exclui essa espera; ambos ausentes de um mecanismo de orquestração que os antecede.

      • workspace_id string
    • truncado booleano

      Relatórios truncados de que a sessão tinha mais linhas do que o OE retorna em uma leitura, então esta é uma visualização parcial. Espelhado da resposta do OE.
  • 400

    Solicitação inválida

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 401

    Não autorizado

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 500

    Erro interno do servidor

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
  • 502

    Gateway incorreto

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • código string
    • Erro string
    • Sucesso 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"
Exemplos de resposta (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"
}
Exemplos de resposta (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"
}
Exemplos de resposta (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
}
Exemplos de resposta (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
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}