Listar sessões de tempo de execução

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

Lista as sessões de tempo de execução que reservam capacidade de sandbox de agente ou ferramenta para o workspace, incluindo sessões que ainda estão liberando capacidade. As sessões de tempo de execução são separadas das sessões de conversa duráveis, que armazenam o histórico de conversas. O status é ativo enquanto a sessão mantém a capacidade e é interrompido enquanto a liberação está em andamento. last_atividade_at e scheduled_release_at seguem o tempo limite ocioso do espaço de trabalho. scheduled_release_at é omitido enquanto um componente ainda está sendo lançado. is_test_session identifica sessões de teste do Playground e CLI. A lista está vazia quando nenhuma capacidade de tempo de execução está reservada. Uma parada aceita ou uma liberação não confirmada permanecem visíveis após uma reinicialização e de cada réplica de tempo de execução. Solicitações de lista simultâneas compartilham uma atualização de status do executor. Uma atualização bem-sucedida é reutilizada por cerca de um segundo. Se a atualização de dois segundos falhar ou retornar dados incompletos, o endpoint usará o snapshot em cache da réplica atual. last_atividade_at usa o relógio da réplica de serviço.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

  • workspace_id string Obrigatório

    ID do espaço de trabalho

Respostas

  • 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 atributo de resposta Mostrar atributo de resposta objeto
    • sessões array[objeto]
      Ocultar atributos das sessões Mostrar atributos das sessões objeto
      • is_test_session booleano
      • last_atividade_at string
      • scheduled_release_at string
      • session_id string
      • Status string
    Ocultar atributo de resposta Mostrar atributo de resposta objeto
    • sessões array[objeto]
      Ocultar atributos das sessões Mostrar atributos das sessões objeto
      • is_test_session booleano
      • last_atividade_at string
      • scheduled_release_at string
      • session_id string
      • Status string
  • 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
  • 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
  • Proibido

    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
  • Não encontrado

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

    O mecanismo de orquestração do espaço de trabalho não está pronto

    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
  • 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
  • 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}/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"
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)
{
  "sessions": [
    {
      "is_test_session": true,
      "last_activity_at": "string",
      "scheduled_release_at": "string",
      "session_id": "string",
      "status": "string"
    }
  ]
}
Exemplos de resposta (200)
{
  "sessions": [
    {
      "is_test_session": true,
      "last_activity_at": "string",
      "scheduled_release_at": "string",
      "session_id": "string",
      "status": "string"
    }
  ]
}
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 (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (403)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (425)
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (425)
{
  "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
}