Listar os sistemas de espaço de trabalho

OBTER /api/v1/projects/{id}/workspaces/{workspace_id}/deployments
Autenticação do portador

Proxies para o ECP para listar os sistemas em um espaço de trabalho com paginação baseada em cursor e filtro de status opcional. O escopo do projeto é realizado pelo parâmetro route id path e a organização é derivada desse projeto.

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

  • workspace_id string Obrigatório

    ID do espaço de trabalho

parâmetros de query

  • cursor string

    Cursor de paginação opaco

  • limit inteiro

    Tamanho da página (1-100, padrão 20)

  • Status string

    Filtro de status da implantação (em fila, in_progress, limpeza_up, bem-sucedida, falha, roll_back, cancelada)

  • fornecido_in_release string

    Retorne as implantações enviadas nesta versão: seus próprios sistemas de artefatos, além das implantações que não são de versão que foram lançadas antes de seu corte. Rollbacks estão excluídos.

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
    • implantações array[objeto]
      Ocultar atributos de sistemas Mostrar atributos de implantações objeto
      • aer_http_endpoint string

        AERHTTPEndpoint é o nome legado do endpoint HTTP da sandbox do agente .

      • agent_http_endpoint string

        AgentHTTPEndpoint é o endpoint HTTP da sandbox do agente . O mesmo valor que aer_http_endpoint.

      • agent_stack_name string
      • app_id string
      • branch string
      • build_id string
      • commit_sha string
      • completed_at string
      • components_images objeto
        Ocultar atributos de components_images Mostrar atributos de components_images objeto
        • aer string

          AER é o nome legado da imagem da sandbox do agente .

        • Agente string

          Agente é a imagem da sandbox do agente . O mesmo valor que aer.

        • memory_server string
        • oe string
        • Ferramenta string
      • Componentes array[objeto]

        Integridade por componente — encaminhado como está do ECP para visualização detalhada.

        Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
        • available booleano
        • failure_message string
        • failure_reason string
        • name string
        • read_replicas inteiro
        • réplicas inteiro

          Réplicas é a contagem de pods desejada. Zero significa que a plataforma não comunicou um; os consumidores não devem tratar zero como escala para zero.

        • sandbox string

          Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.

        • type string
      • condições array[objeto]
        Ocultar atributos de condições Mostrar atributos de condições objeto
        • last_transition_time string
        • mensagem string
        • Razão string
        • Status string
        • type string
      • created_at string

        Carimbos de data/hora.

      • deployment_id string

        Identity & status principal ( sempre presente ).

      • duration_ms inteiro
      • error_message string

        Contexto de falha — exibido para que as UIs de administrador possam fazer a triagem sem ir primeiro ao Splunk.

      • executor_type string
      • first_deploy booleano

        O FirstDeploy é verdadeiro para todas as tentativas até (e incluindo) a primeira implantação bem-sucedida do espaço de trabalho. Omitido quando desconhecido.

      • saúde objeto

        Campos estendidos.

        Ocultar atributos de integridade Mostrar atributos de integridade objeto
        • available booleano
        • check_at string
        • Componentes array[objeto]
          Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
          • name string
          • pronto booleano
          • read_replicas inteiro
          • sandbox string

            Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.

      • page_uri string

        Imagem / fonte.

      • Linguagem string

        Idioma é o idioma de tempo de execução do agente ("python" | "typescript"), encaminhado pelo ECP. Omitido quando não definido (as construções mais antigas são padronizadas para o python downstream).

      • last_event_seq inteiro
      • memory_enabled booleano

        MemoryEnabled é a configuração de memória de tempo de execução efetiva do sistema. Omitido quando indisponível.

      • missing_secrets array[string]
      • operator_namespace string
      • org_id string
      • post_deploy_error_message string
      • anterior_imagem_uri string
      • project_deleted booleano

        Verdadeiro quando o projeto proprietário do sistema tiver sido excluído de forma reversível. Sempre emitido para que os consumidores possam se ramificar no campo, não em sua ausência.

      • PROJECT_ID string
      • release_number inteiro

        ReleaseNumber é o identificador de versão monotônica por espaço de trabalho (conduz o rótulo v{N} na UI). 0/omitido para registros legado antes da migração de preenchimento.

      • imagens_solicitadas array[objeto]

        RequestedImages é uma intenção de implantação fixada em resumo. Omitido para sistemas legado criados antes que o rastreamento de resumo de imagens fosse ativado; [] significa que o escritor executou, mas não conseguiu resolver nada.

        Ocultar atributos de query_images Mostrar atributos de requires_images objeto
        • componente string
        • digerir string
        • sandbox string

          Sandbox é o nome canônico da sandbox para valores de componentes conhecidos. Omitido para nomes upstream desconhecidos.

      • ordered_target_id string

        RequestedTargetID é procedência interna da Frota e intencionalmente não é exibido pelas respostas do Gateway. Permanece vazio para compatibilidade.

      • rollback_error string
      • rollback_from_id string

        definido quando este sistema foi revertido de

      • rollback_of string

        Vinculação de rollback.

      • fornecido_in_release string

        ShuppedInRelease é a versão que enviou esta implantação. Omitido quando não pertence a nenhum. Encaminhado pela ECP; derivado no tempo de leitura.

      • source_build_id string
      • source_project_id string
      • source_promoção_id string
      • source_workspace_id string
      • started_at string
      • Status string
      • target_namespace string

        Colocação do Kubernetes.

      • Trigger string
      • updated_at string
      • Versão string

        Versão é a versão do agente declarada pelo desenvolvedor encaminhada pelo ECP. Omitido para registros não versionados.

    • limit inteiro

      Definido pela lista de administração de toda a plataforma paginada com offset. Os endpoints por espaço de trabalho os deixam com valor zero e são omitidos na conexão.

    • próximo_cursor string

      Definido pela lista de administração por espaço de trabalho paginada por cursor. Os endpoints de toda a plataforma o tornam nulo.

    • offset inteiro
    • Total inteiro
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • implantações array[objeto]
      Ocultar atributos de sistemas Mostrar atributos de implantações objeto
      • aer_http_endpoint string

        AERHTTPEndpoint é o nome legado do endpoint HTTP da sandbox do agente .

      • agent_http_endpoint string

        AgentHTTPEndpoint é o endpoint HTTP da sandbox do agente . O mesmo valor que aer_http_endpoint.

      • agent_stack_name string
      • app_id string
      • branch string
      • build_id string
      • commit_sha string
      • completed_at string
      • components_images objeto
        Ocultar atributos de components_images Mostrar atributos de components_images objeto
        • aer string

          AER é o nome legado da imagem da sandbox do agente .

        • Agente string

          Agente é a imagem da sandbox do agente . O mesmo valor que aer.

        • memory_server string
        • oe string
        • Ferramenta string
      • Componentes array[objeto]

        Integridade por componente — encaminhado como está do ECP para visualização detalhada.

        Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
        • available booleano
        • failure_message string
        • failure_reason string
        • name string
        • read_replicas inteiro
        • réplicas inteiro

          Réplicas é a contagem de pods desejada. Zero significa que a plataforma não comunicou um; os consumidores não devem tratar zero como escala para zero.

        • sandbox string

          Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.

        • type string
      • condições array[objeto]
        Ocultar atributos de condições Mostrar atributos de condições objeto
        • last_transition_time string
        • mensagem string
        • Razão string
        • Status string
        • type string
      • created_at string

        Carimbos de data/hora.

      • deployment_id string

        Identity & status principal ( sempre presente ).

      • duration_ms inteiro
      • error_message string

        Contexto de falha — exibido para que as UIs de administrador possam fazer a triagem sem ir primeiro ao Splunk.

      • executor_type string
      • first_deploy booleano

        O FirstDeploy é verdadeiro para todas as tentativas até (e incluindo) a primeira implantação bem-sucedida do espaço de trabalho. Omitido quando desconhecido.

      • saúde objeto

        Campos estendidos.

        Ocultar atributos de integridade Mostrar atributos de integridade objeto
        • available booleano
        • check_at string
        • Componentes array[objeto]
          Ocultar atributos dos componentes Mostrar atributos dos componentes objeto
          • name string
          • pronto booleano
          • read_replicas inteiro
          • sandbox string

            Sandbox é o nome canônico da sandbox para valores de componentes conhecidos (agente, ferramenta). Omitido para nomes upstream desconhecidos.

      • page_uri string

        Imagem / fonte.

      • Linguagem string

        Idioma é o idioma de tempo de execução do agente ("python" | "typescript"), encaminhado pelo ECP. Omitido quando não definido (as construções mais antigas são padronizadas para o python downstream).

      • last_event_seq inteiro
      • memory_enabled booleano

        MemoryEnabled é a configuração de memória de tempo de execução efetiva do sistema. Omitido quando indisponível.

      • missing_secrets array[string]
      • operator_namespace string
      • org_id string
      • post_deploy_error_message string
      • anterior_imagem_uri string
      • project_deleted booleano

        Verdadeiro quando o projeto proprietário do sistema tiver sido excluído de forma reversível. Sempre emitido para que os consumidores possam se ramificar no campo, não em sua ausência.

      • PROJECT_ID string
      • release_number inteiro

        ReleaseNumber é o identificador de versão monotônica por espaço de trabalho (conduz o rótulo v{N} na UI). 0/omitido para registros legado antes da migração de preenchimento.

      • imagens_solicitadas array[objeto]

        RequestedImages é uma intenção de implantação fixada em resumo. Omitido para sistemas legado criados antes que o rastreamento de resumo de imagens fosse ativado; [] significa que o escritor executou, mas não conseguiu resolver nada.

        Ocultar atributos de query_images Mostrar atributos de requires_images objeto
        • componente string
        • digerir string
        • sandbox string

          Sandbox é o nome canônico da sandbox para valores de componentes conhecidos. Omitido para nomes upstream desconhecidos.

      • ordered_target_id string

        RequestedTargetID é procedência interna da Frota e intencionalmente não é exibido pelas respostas do Gateway. Permanece vazio para compatibilidade.

      • rollback_error string
      • rollback_from_id string

        definido quando este sistema foi revertido de

      • rollback_of string

        Vinculação de rollback.

      • fornecido_in_release string

        ShuppedInRelease é a versão que enviou esta implantação. Omitido quando não pertence a nenhum. Encaminhado pela ECP; derivado no tempo de leitura.

      • source_build_id string
      • source_project_id string
      • source_promoção_id string
      • source_workspace_id string
      • started_at string
      • Status string
      • target_namespace string

        Colocação do Kubernetes.

      • Trigger string
      • updated_at string
      • Versão string

        Versão é a versão do agente declarada pelo desenvolvedor encaminhada pelo ECP. Omitido para registros não versionados.

    • limit inteiro

      Definido pela lista de administração de toda a plataforma paginada com offset. Os endpoints por espaço de trabalho os deixam com valor zero e são omitidos na conexão.

    • próximo_cursor string

      Definido pela lista de administração por espaço de trabalho paginada por cursor. Os endpoints de toda a plataforma o tornam nulo.

    • offset inteiro
    • Total inteiro
  • 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
  • 403

    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
  • 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}/workspaces/{workspace_id}/deployments 
curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}/deployments' \
 --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) 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
Exemplos de resposta (200) 
{
  "deployments": [
    {
      "aer_http_endpoint": "string",
      "agent_http_endpoint": "string",
      "agent_stack_name": "string",
      "app_id": "string",
      "branch": "string",
      "build_id": "string",
      "commit_sha": "string",
      "completed_at": "string",
      "component_images": {
        "aer": "string",
        "agent": "string",
        "memory_server": "string",
        "oe": "string",
        "tool": "string"
      },
      "components": [
        {
          "available": true,
          "failure_message": "string",
          "failure_reason": "string",
          "name": "string",
          "ready_replicas": 42,
          "replicas": 42,
          "sandbox": "string",
          "type": "string"
        }
      ],
      "conditions": [
        {
          "last_transition_time": "string",
          "message": "string",
          "reason": "string",
          "status": "string",
          "type": "string"
        }
      ],
      "created_at": "string",
      "deployment_id": "string",
      "duration_ms": 42,
      "error_message": "string",
      "executor_type": "string",
      "first_deploy": true,
      "health": {
        "available": true,
        "checked_at": "string",
        "components": [
          {
            "name": "string",
            "ready": true,
            "ready_replicas": 42,
            "sandbox": "string"
          }
        ]
      },
      "image_uri": "string",
      "language": "string",
      "last_event_seq": 42,
      "memory_enabled": true,
      "missing_secrets": [
        "string"
      ],
      "operator_namespace": "string",
      "org_id": "string",
      "post_deploy_error_message": "string",
      "previous_image_uri": "string",
      "project_deleted": true,
      "project_id": "string",
      "release_number": 42,
      "requested_images": [
        {
          "component": "string",
          "digest": "string",
          "sandbox": "string"
        }
      ],
      "requested_target_id": "string",
      "rollback_error": "string",
      "rollback_from_id": "string",
      "rollback_of": "string",
      "shipped_in_release": "string",
      "source_build_id": "string",
      "source_project_id": "string",
      "source_promotion_id": "string",
      "source_workspace_id": "string",
      "started_at": "string",
      "status": "string",
      "target_namespace": "string",
      "trigger": "string",
      "updated_at": "string",
      "version": "string"
    }
  ],
  "limit": 42,
  "next_cursor": "string",
  "offset": 42,
  "total": 42
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400) 
{
  "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 (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}