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

Lista sessões de conversa duráveis em cada espaço de trabalho no projeto, com o ativo mais recente primeiro. Essas sessões contêm mensagens e execuções de execução. Elas são separadas das sessões de tempo de execução, que acompanham a capacidade reservada da sandbox. Para obter a próxima página, passe próximo_cursor da resposta como cursor.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

parâmetros de query

  • limit inteiro

    Máximo de resultados (padrão 50, máximo de 200)

  • workspace_id string

    Restringir a um único workspace

  • Status string

    Filtrar pelo último status de execução da sessão

  • desde string

    Somente sessões com atividade neste ou após este RFC3339 time

  • até que string

    Somente sessões com atividade antes deste tempo de RFC3339

  • cursor string

    Token de paginação opaco do próximo_cursor de uma resposta anterior

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
    • has_more booleano
    • limit inteiro
    • próximo_cursor string

      NextCursor é um token opaco para passar de volta como o parâmetro de query cursor, nulo quando esta página é a última. Opaco para que a posição da paginação possa mudar de forma sem quebrar os clientes, correspondendo à convenção que os outros endpoints paginados neste gateway já usam.

    • sessões array[objeto]
      Ocultar atributos das sessões Mostrar atributos das sessões objeto
      • Active_duration_ms inteiro

        ActiveDurationMS soma o tempo decorrido de cada execução, portanto, ele coincide com as durações por execução que os pontos de extremidade de execuções da sessão relatam e exclui as lacunas entre as voltas. Zero de um mecanismo de orquestração que o antecede.

      • created_at string
      • first_message_preview string
      • last_active string
      • últimas_status string

        LatestStatus é o status da execução mais recente da sessão.

      • PROJECT_ID string
      • session_id string
      • total_duration_ms inteiro

        TotalDurationMS é o tempo decorrido do relógio da primeira execução da sessão até sua última atividade, portanto, inclui o tempo ocioso entre as voltas.

      • total_tokens inteiro

        TotalTokens é um limite inferior: ele soma as contagens por chamada registradas para chamadas LLM roteadas pelo OE e exclui tokens de extração de memória.

      • transforma inteiro
      • user_id string
      • visibilidade string
      • wait_ms inteiro

        O WaitMS soma a espera de revisão humana resolvida nas execuções da sessão, além da janela aberta até agora em uma atualmente suspensa. Zero de um mecanismo de orquestração que o antecede.

      • workspace_id string
    • total_count inteiro

      TotalCount é o número de sessões que correspondem ao filtro. Presente apenas na primeira página: contá-la significa buscar cada correspondência, que é o que a paginação do cursor existe para evitar, e não pode mudar no meio da caminhada.

    • truncado booleano
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • has_more booleano
    • limit inteiro
    • próximo_cursor string

      NextCursor é um token opaco para passar de volta como o parâmetro de query cursor, nulo quando esta página é a última. Opaco para que a posição da paginação possa mudar de forma sem quebrar os clientes, correspondendo à convenção que os outros endpoints paginados neste gateway já usam.

    • sessões array[objeto]
      Ocultar atributos das sessões Mostrar atributos das sessões objeto
      • Active_duration_ms inteiro

        ActiveDurationMS soma o tempo decorrido de cada execução, portanto, ele coincide com as durações por execução que os pontos de extremidade de execuções da sessão relatam e exclui as lacunas entre as voltas. Zero de um mecanismo de orquestração que o antecede.

      • created_at string
      • first_message_preview string
      • last_active string
      • últimas_status string

        LatestStatus é o status da execução mais recente da sessão.

      • PROJECT_ID string
      • session_id string
      • total_duration_ms inteiro

        TotalDurationMS é o tempo decorrido do relógio da primeira execução da sessão até sua última atividade, portanto, inclui o tempo ocioso entre as voltas.

      • total_tokens inteiro

        TotalTokens é um limite inferior: ele soma as contagens por chamada registradas para chamadas LLM roteadas pelo OE e exclui tokens de extração de memória.

      • transforma inteiro
      • user_id string
      • visibilidade string
      • wait_ms inteiro

        O WaitMS soma a espera de revisão humana resolvida nas execuções da sessão, além da janela aberta até agora em uma atualmente suspensa. Zero de um mecanismo de orquestração que o antecede.

      • workspace_id string
    • total_count inteiro

      TotalCount é o número de sessões que correspondem ao filtro. Presente apenas na primeira página: contá-la significa buscar cada correspondência, que é o que a paginação do cursor existe para evitar, e não pode mudar no meio da caminhada.

    • truncado booleano
  • 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 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/sessions' \
 --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) 
{
  "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
}
Exemplos de resposta (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
}
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
}