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.
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.
-
OK
-
Solicitação inválida
-
Não autorizado
-
Proibido
-
Não encontrado
-
O mecanismo de orquestração do espaço de trabalho não está pronto
-
Erro interno do servidor
-
Gateway incorreto
curl \
--request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/runtime-sessions' \
--header "Authorization: $API_KEY"
{
"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"
}
{
"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"
}
{
"sessions": [
{
"is_test_session": true,
"last_activity_at": "string",
"scheduled_release_at": "string",
"session_id": "string",
"status": "string"
}
]
}
{
"sessions": [
{
"is_test_session": true,
"last_activity_at": "string",
"scheduled_release_at": "string",
"session_id": "string",
"status": "string"
}
]
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}