Listar implementaciones de espacios de trabajo

OBTENER /api/v1/projects/{id}/workspaces/{workspace_id}/deployments

Se utilizan proxies para ECP para listar las implementaciones de un espacio de trabajo con paginación basada en cursor y filtro de estado opcional. El ámbito del proyecto se define mediante el parámetro de ruta id, y la organización se deriva de dicho proyecto.

Parámetros de path

ID string Requerido

ID del proyecto
ID del espacio de trabajo string Requerido

ID del espacio de trabajo

Parámetros de query

cursor string

cursor de paginación opaco
limit entero

Tamaño de página (1-100, predeterminado 20)
Estado string

Filtro de estado de despliegue (en cola, en curso, limpiando, correcto, fallido, revertido, cancelado)
enviado_en_lanzamiento string

Devuelve las implementaciones que se enviaron en esta versión: sus propias implementaciones de artefactos más las implementaciones que no son de la versión y que se realizaron antes de su corte. Se excluyen las reversiones.

Respuestas

406

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- badRequestDetail Objeto
  
  Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.
  
  Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
  
  Campos arreglo[objeto]
  
  Campos con errores de validación.
  
  Ocultar campos atributos Mostrar los atributos de los campos Objeto
  
  Un campo y su fallo de validación.
  
  Descripción string Requerido
  
  Fallo en la validación legible para humanos.
  
  Campo string Requerido
  
  Nombre o ruta del campo de solicitud no válido.
- detalle string Requerido
  
  Detalles de errores legibles para humanos.
- Error entero Requerido
  
  HTTP status code.
- errorCode string Requerido
  
  Código de error legible por máquina.
- Parámetros array[string]
  
  Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.
- motivo string Requerido
  
  Frase que indica el motivo del estado HTTP.
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- badRequestDetail Objeto
  
  Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.
  
  Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
  
  Campos arreglo[objeto]
  
  Campos con errores de validación.
  
  Ocultar campos atributos Mostrar los atributos de los campos Objeto
  
  Un campo y su fallo de validación.
  
  Descripción string Requerido
  
  Fallo en la validación legible para humanos.
  
  Campo string Requerido
  
  Nombre o ruta del campo de solicitud no válido.
- detalle string Requerido
  
  Detalles de errores legibles para humanos.
- Error entero Requerido
  
  HTTP status code.
- errorCode string Requerido
  
  Código de error legible por máquina.
- Parámetros array[string]
  
  Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.
- motivo string Requerido
  
  Frase que indica el motivo del estado HTTP.
200

aplicación/vnd.agent-engine-2026-09-20-preview+json

aplicación/vnd.agent-engine-2026-09-20-preview+json application/json

OK
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Implementaciones arreglo[objeto]
  
  Ocultar atributos de implementaciones Mostrar atributos de implementaciones Objeto
  
  aer_http_endpoint string
  
  AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.
  
  agent_http_endpoint string
  
  AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.
  
  agent_stack_name string
  
  app_id string
  
  sucursal string
  
  ID de compilación string
  
  commit_sha string
  
  completed_at string
  
  imágenes_componentes Objeto
  
  Ocultar atributos de component_images Mostrar atributos de component_images Objeto
  
  aer string
  
  AER es el nombre anterior de la imagen del entorno aislado del agente.
  
  agente string
  
  Agent es la imagen del entorno aislado del agente. Tiene el mismo valor que aer.
  
  servidor de memoria string
  
  oe string
  
  Herramienta string
  
  Componentes arreglo[objeto]
  
  Estado de cada componente: se envía tal cual desde ECP para la vista detallada.
  
  Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
  
  available booleano
  
  mensaje de error string
  
  motivo de fallo string
  
  Nombre string
  
  réplicas listas entero
  
  replicas entero
  
  Replicas es el número de pods deseado. Cero significa que la plataforma no ha informado de ninguno; los consumidores no deben interpretar cero como escalado a cero.
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.
  
  tipo string
  
  condiciones arreglo[objeto]
  
  Ocultar atributos de condiciones Mostrar atributos de condiciones Objeto
  
  último_tiempo_de_transición string
  
  mensaje string
  
  motivo string
  
  Estado string
  
  tipo string
  
  created_at string
  
  Marcas de tiempo.
  
  id_de_despliegue string
  
  Identidad y estado central (siempre presente).
  
  duración_ms entero
  
  mensaje de error string
  
  Contexto de fallo: se muestra para que las interfaces de usuario de administración puedan priorizar el problema sin tener que recurrir primero a Splunk.
  
  tipo_ejecutor string
  
  primer despliegue booleano
  
  FirstDeploy se cumple en cada intento hasta (e incluyendo) el primer despliegue exitoso del espacio de trabajo. Se omite cuando se desconoce.
  
  salud Objeto
  
  Campos extendidos.
  
  Ocultar atributos de salud Mostrar atributos de salud Objeto
  
  available booleano
  
  comprobado_en string
  
  Componentes arreglo[objeto]
  
  Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
  
  Nombre string
  
  Listo booleano
  
  réplicas listas entero
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.
  
  imagen_uri string
  
  Imagen / fuente.
  
  Idioma string
  
  El lenguaje es el lenguaje de ejecución del agente ("python" | "typescript"), proporcionado por ECP. Se omite cuando no se especifica (las versiones anteriores usan python por defecto).
  
  last_event_seq entero
  
  memoria habilitada booleano
  
  MemoryEnabled es la configuración de memoria efectiva en tiempo de ejecución de la implementación. Se omite cuando no está disponible.
  
  secretos perdidos array[string]
  
  operator_namespace string
  
  org_id string
  
  mensaje_de_error_post_deploy string
  
  URI de imagen anterior string
  
  proyecto_eliminado booleano
  
  Cierto cuando el proyecto propietario del despliegue se ha eliminado de forma lógica. Siempre se emite para que los consumidores puedan ramificarse en el campo, no en su ausencia.
  
  project_id string
  
  número_de_lanzamiento entero
  
  ReleaseNumber es el identificador de versión monótono por espacio de trabajo (controla la etiqueta v{N} en la interfaz de usuario). 0/omitido para registros heredados antes de la migración de relleno.
  
  imágenes_solicitadas arreglo[objeto]
  
  RequestedImages es una intención de despliegue anclada al resumen. Se omite para despliegues heredados creados antes de que se habilitara el seguimiento del resumen de imágenes; [] significa que el escritor se ejecutó pero no resolvió nada.
  
  Ocultar los atributos de requested_images Mostrar atributos de requested_images Objeto
  
  componente string
  
  digest string
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos. Se omite para los nombres de origen desconocidos.
  
  ID de destino solicitado string
  
  RequestedTargetID es un identificador interno de la flota y no se muestra intencionadamente en las respuestas de Gateway. Permanece vacío por motivos de compatibilidad.
  
  rollback_error string
  
  rollback_from_id string
  
  establecido cuando se revirtió esta implementación
  
  rollback_of string
  
  Mecanismo de retroceso.
  
  enviado_en_lanzamiento string
  
  ShippedInRelease es la versión que envió esta implementación. Se omite cuando no pertenece a ninguna. Reenviado desde ECP; derivado en el momento de la lectura.
  
  source_build_id string
  
  ID del proyecto de origen string
  
  ID de promoción de origen string
  
  source_workspace_id string
  
  comenzó_en string
  
  Estado string
  
  espacio_de_nombres_destino string
  
  Ubicación de Kubernetes.
  
  Activador string
  
  updated_at string
  
  Versión string
  
  La versión es la versión del agente declarada por el desarrollador y enviada desde ECP. Se omite para los registros sin versión.
- limit entero
  
  Establecido por la lista de administración de la plataforma con paginación desplazada. Los puntos finales por espacio de trabajo dejan estos valores en cero y se omiten en la transmisión.
- siguiente_cursor string
  
  Establecido por la lista de administración por espacio de trabajo paginada por cursor. Los puntos finales de toda la plataforma lo dejan nulo.
- desplazamiento entero
- Total entero
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Implementaciones arreglo[objeto]
  
  Ocultar atributos de implementaciones Mostrar atributos de implementaciones Objeto
  
  aer_http_endpoint string
  
  AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.
  
  agent_http_endpoint string
  
  AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.
  
  agent_stack_name string
  
  app_id string
  
  sucursal string
  
  ID de compilación string
  
  commit_sha string
  
  completed_at string
  
  imágenes_componentes Objeto
  
  Ocultar atributos de component_images Mostrar atributos de component_images Objeto
  
  aer string
  
  AER es el nombre anterior de la imagen del entorno aislado del agente.
  
  agente string
  
  Agent es la imagen del entorno aislado del agente. Tiene el mismo valor que aer.
  
  servidor de memoria string
  
  oe string
  
  Herramienta string
  
  Componentes arreglo[objeto]
  
  Estado de cada componente: se envía tal cual desde ECP para la vista detallada.
  
  Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
  
  available booleano
  
  mensaje de error string
  
  motivo de fallo string
  
  Nombre string
  
  réplicas listas entero
  
  replicas entero
  
  Replicas es el número de pods deseado. Cero significa que la plataforma no ha informado de ninguno; los consumidores no deben interpretar cero como escalado a cero.
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.
  
  tipo string
  
  condiciones arreglo[objeto]
  
  Ocultar atributos de condiciones Mostrar atributos de condiciones Objeto
  
  último_tiempo_de_transición string
  
  mensaje string
  
  motivo string
  
  Estado string
  
  tipo string
  
  created_at string
  
  Marcas de tiempo.
  
  id_de_despliegue string
  
  Identidad y estado central (siempre presente).
  
  duración_ms entero
  
  mensaje de error string
  
  Contexto de fallo: se muestra para que las interfaces de usuario de administración puedan priorizar el problema sin tener que recurrir primero a Splunk.
  
  tipo_ejecutor string
  
  primer despliegue booleano
  
  FirstDeploy se cumple en cada intento hasta (e incluyendo) el primer despliegue exitoso del espacio de trabajo. Se omite cuando se desconoce.
  
  salud Objeto
  
  Campos extendidos.
  
  Ocultar atributos de salud Mostrar atributos de salud Objeto
  
  available booleano
  
  comprobado_en string
  
  Componentes arreglo[objeto]
  
  Ocultar atributos de componentes Mostrar los atributos de los componentes Objeto
  
  Nombre string
  
  Listo booleano
  
  réplicas listas entero
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos (agente, herramienta). Se omite para los nombres de origen desconocidos.
  
  imagen_uri string
  
  Imagen / fuente.
  
  Idioma string
  
  El lenguaje es el lenguaje de ejecución del agente ("python" | "typescript"), proporcionado por ECP. Se omite cuando no se especifica (las versiones anteriores usan python por defecto).
  
  last_event_seq entero
  
  memoria habilitada booleano
  
  MemoryEnabled es la configuración de memoria efectiva en tiempo de ejecución de la implementación. Se omite cuando no está disponible.
  
  secretos perdidos array[string]
  
  operator_namespace string
  
  org_id string
  
  mensaje_de_error_post_deploy string
  
  URI de imagen anterior string
  
  proyecto_eliminado booleano
  
  Cierto cuando el proyecto propietario del despliegue se ha eliminado de forma lógica. Siempre se emite para que los consumidores puedan ramificarse en el campo, no en su ausencia.
  
  project_id string
  
  número_de_lanzamiento entero
  
  ReleaseNumber es el identificador de versión monótono por espacio de trabajo (controla la etiqueta v{N} en la interfaz de usuario). 0/omitido para registros heredados antes de la migración de relleno.
  
  imágenes_solicitadas arreglo[objeto]
  
  RequestedImages es una intención de despliegue anclada al resumen. Se omite para despliegues heredados creados antes de que se habilitara el seguimiento del resumen de imágenes; [] significa que el escritor se ejecutó pero no resolvió nada.
  
  Ocultar los atributos de requested_images Mostrar atributos de requested_images Objeto
  
  componente string
  
  digest string
  
  sandbox string
  
  Sandbox es el nombre canónico del entorno aislado para los valores de componentes conocidos. Se omite para los nombres de origen desconocidos.
  
  ID de destino solicitado string
  
  RequestedTargetID es un identificador interno de la flota y no se muestra intencionadamente en las respuestas de Gateway. Permanece vacío por motivos de compatibilidad.
  
  rollback_error string
  
  rollback_from_id string
  
  establecido cuando se revirtió esta implementación
  
  rollback_of string
  
  Mecanismo de retroceso.
  
  enviado_en_lanzamiento string
  
  ShippedInRelease es la versión que envió esta implementación. Se omite cuando no pertenece a ninguna. Reenviado desde ECP; derivado en el momento de la lectura.
  
  source_build_id string
  
  ID del proyecto de origen string
  
  ID de promoción de origen string
  
  source_workspace_id string
  
  comenzó_en string
  
  Estado string
  
  espacio_de_nombres_destino string
  
  Ubicación de Kubernetes.
  
  Activador string
  
  updated_at string
  
  Versión string
  
  La versión es la versión del agente declarada por el desarrollador y enviada desde ECP. Se omite para los registros sin versión.
- limit entero
  
  Establecido por la lista de administración de la plataforma con paginación desplazada. Los puntos finales por espacio de trabajo dejan estos valores en cero y se omiten en la transmisión.
- siguiente_cursor string
  
  Establecido por la lista de administración por espacio de trabajo paginada por cursor. Los puntos finales de toda la plataforma lo dejan nulo.
- desplazamiento entero
- Total entero
400

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

Solicitud incorrecta
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito booleano
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito booleano
403

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

Forbidden
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito booleano
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito booleano
502

application/json

application/json aplicación/vnd.agent-engine-2026-09-20-preview+json

Puerta de enlace incorrecta
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito booleano
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Código string
- Error string
- éxito 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"

Ejemplos de respuesta (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"
}

Ejemplos de respuesta (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"
}

Ejemplos de respuesta (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
}

Ejemplos de respuesta (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
}

Ejemplos de respuesta (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Ejemplos de respuesta (400)

{
  "code": "string",
  "error": "string",
  "success": true
}

Ejemplos de respuesta (403)

{
  "code": "string",
  "error": "string",
  "success": true
}

Ejemplos de respuesta (403)

{
  "code": "string",
  "error": "string",
  "success": true
}

Ejemplos de respuesta (502)

{
  "code": "string",
  "error": "string",
  "success": true
}

Ejemplos de respuesta (502)

{
  "code": "string",
  "error": "string",
  "success": true
}