Listar espacios de trabajo

OBTENER /api/v1/proyectos/{id}/espaciosdetrabajo

Devuelve todos los espacios de trabajo del proyecto identificados por el parámetro de ruta id. Requiere un token Bearer válido y un rol de proyecto.

Parámetros de path

ID string Requerido

ID del proyecto

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
- Total entero
- espacios de trabajo arreglo[objeto]
  
  Ocultar atributos de espacios de trabajo Mostrar atributos de los espacios de trabajo Objeto
  
  aer_http_endpoint string
  
  AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.
  
  tarjeta_de_agente Objeto
  
  Ocultar atributos de la tarjeta del agente Mostrar atributos de la tarjeta del agente Objeto
  
  a2a_llamadas_permitidas array[string]
  
  A2AAllowedCallers restringe qué ID de espacio de trabajo pueden invocar a este agente a través de A2A. Una lista vacía significa que se permite cualquier llamador.
  
  a2a_habilitado booleano
  
  A2AEnabled controla si este agente es detectable para las llamadas A2A.
  
  capacidades array[string]
  
  input_modes array[string]
  
  InputModes enumera los tipos MIME que acepta el agente (por ejemplo, "text/plain", "application/json").
  
  output_modes array[string]
  
  OutputModes enumera los tipos MIME que el agente puede producir.
  
  habilidades arreglo[objeto]
  
  Skills anuncia tareas específicas que el agente puede realizar.
  
  Ocultar atributos de habilidades Mostrar atributos de habilidades Objeto
  
  Descripción string
  
  entrada de ejemplo string
  
  ejemplo_de_salida string
  
  Nombre string
  
  Resumen string
  
  agent_grpc_endpoint string
  
  agent_http_endpoint string
  
  AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.
  
  auto_deploy booleano
  
  AutoDeploy es el interruptor de despliegue automático por aplicación, propiedad de ECP. Se obtiene en cada solicitud GET de detalles (no se almacena en la base de datos de la puerta de enlace). Está ausente cuando ECP no tiene valor o no está disponible; la interfaz de usuario interpreta la ausencia como desactivada.
  
  tasa_de_finalización Número
  
  fecha_creación string
  
  id_de_despliegue_actual string
  
  referencia_de_carga_útil_actual string
  
  Descripción string
  
  Funcionalidades Objeto
  
  Ocultar atributos de características Mostrar atributos de las características Objeto
  
  barandillas de seguridad booleano
  
  memoria booleano
  
  patio de recreo booleano
  
  Playground informa si la interfaz de usuario de Playground está configurada para el espacio de trabajo (nil/true = configurada, comportamiento actual). Si es falso, los usuarios utilizan la API de invocación directamente.
  
  usar_analizador_personalizado booleano
  
  UseCustomParser, cuando es verdadero, hace que Gateway emita solo los eventos personalizados del analizador de salida del agente en el flujo de invocación (descartando los marcos de la plataforma). Se conserva desde las características de agent.yaml en agentengine init.
  
  Marco string
  
  github_installation_id entero
  
  GithubInstallationID es la instalación de la aplicación GitHub propietaria del repositorio. Pertenece a ECP y se obtiene en cada solicitud GET de detalles (no se almacena en la base de datos de la puerta de enlace), por lo que funciona para espacios de trabajo creados antes de que existiera este campo. La interfaz de usuario lo necesita para mostrar las ramas del repositorio al editar la rama que se está siguiendo.
  
  gitops Objeto
  
  Ocultar atributos de gitops Mostrar atributos de gitops Objeto
  
  sucursal string
  
  referencia_de_conexión string
  
  github_installation_id integer(int64)
  
  ruta_del_manifiesto string
  
  Proveedor string
  
  repo_url string
  
  ID string
  
  Instancias Objeto
  
  El campo Instances informa sobre el número de instancias del espacio de trabajo (activas, en espera e iniciando), así como el tiempo de lectura obtenido de la celda OE del espacio de trabajo. No se muestra cuando OE no está disponible o el espacio de trabajo no se ejecuta en modo pool (p. ej., modo contenedor). Se omite deliberadamente cualquier nomenclatura de implementación interna: este es un campo visible para el cliente.
  
  Ocultar atributos de instancias Mostrar atributos de instancias Objeto
  
  Activo entero
  
  agrupada booleano
  
  standby entero
  
  Inicio entero
  
  invocaciones entero
  
  Métricas de ejecución en una ventana deslizante de 24h. Los cinco campos son punteros para que el cable pueda distinguir dos casos en los que la interfaz de usuario necesita renderizar de manera diferente: (a) la obtención de métricas OE falló (fallo suave: los cinco campos están ausentes), o (b) la ventana contiene cero invocaciones / ninguna ejecución completada (Invocaciones está establecido en 0 y los campos de latencia/tasa están ausentes). La interfaz de usuario distingue "—" de "0 invocaciones" mediante Invocaciones != nil.
  
  Idioma string
  
  última_invocación_en string(date-time)
  
  métricas_calculadas_en string(date-time)
  
  metrics_window_start string(date-time)
  
  Nombre string
  
  org_id string
  
  latencia p95_ms Número
  
  project_id string
  
  modo de liberación string
  
  ReleaseMode es la política de liberación de webhook propiedad de ECP ("push" | "tag-release" | "api-only"). Se obtiene en cada solicitud GET de detalles; no está presente cuando ECP no tiene valor o no está disponible.
  
  Estado string
  
  El estado es la señal activa/en pausa propiedad de ECP. La puerta de enlace la obtiene de ECP en cada solicitud GET de detalles; no se almacena localmente. No aparece cuando ECP no está disponible; la interfaz de usuario interpreta la ausencia como si el estado no estuviera en pausa.
  
  Los valores son active, paused, error, disconnected o deleting.
  
  subdirectorio string
  
  updated_date string
  
  ID del espacio de trabajo string
  
  nombre_del_espacio_de_trabajo string
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- Total entero
- espacios de trabajo arreglo[objeto]
  
  Ocultar atributos de espacios de trabajo Mostrar atributos de los espacios de trabajo Objeto
  
  aer_http_endpoint string
  
  AERHTTPEndpoint es el nombre anterior del punto final HTTP del entorno aislado del agente.
  
  tarjeta_de_agente Objeto
  
  Ocultar atributos de la tarjeta del agente Mostrar atributos de la tarjeta del agente Objeto
  
  a2a_llamadas_permitidas array[string]
  
  A2AAllowedCallers restringe qué ID de espacio de trabajo pueden invocar a este agente a través de A2A. Una lista vacía significa que se permite cualquier llamador.
  
  a2a_habilitado booleano
  
  A2AEnabled controla si este agente es detectable para las llamadas A2A.
  
  capacidades array[string]
  
  input_modes array[string]
  
  InputModes enumera los tipos MIME que acepta el agente (por ejemplo, "text/plain", "application/json").
  
  output_modes array[string]
  
  OutputModes enumera los tipos MIME que el agente puede producir.
  
  habilidades arreglo[objeto]
  
  Skills anuncia tareas específicas que el agente puede realizar.
  
  Ocultar atributos de habilidades Mostrar atributos de habilidades Objeto
  
  Descripción string
  
  entrada de ejemplo string
  
  ejemplo_de_salida string
  
  Nombre string
  
  Resumen string
  
  agent_grpc_endpoint string
  
  agent_http_endpoint string
  
  AgentHTTPEndpoint es el punto final HTTP del entorno aislado del agente. Tiene el mismo valor que aer_http_endpoint.
  
  auto_deploy booleano
  
  AutoDeploy es el interruptor de despliegue automático por aplicación, propiedad de ECP. Se obtiene en cada solicitud GET de detalles (no se almacena en la base de datos de la puerta de enlace). Está ausente cuando ECP no tiene valor o no está disponible; la interfaz de usuario interpreta la ausencia como desactivada.
  
  tasa_de_finalización Número
  
  fecha_creación string
  
  id_de_despliegue_actual string
  
  referencia_de_carga_útil_actual string
  
  Descripción string
  
  Funcionalidades Objeto
  
  Ocultar atributos de características Mostrar atributos de las características Objeto
  
  barandillas de seguridad booleano
  
  memoria booleano
  
  patio de recreo booleano
  
  Playground informa si la interfaz de usuario de Playground está configurada para el espacio de trabajo (nil/true = configurada, comportamiento actual). Si es falso, los usuarios utilizan la API de invocación directamente.
  
  usar_analizador_personalizado booleano
  
  UseCustomParser, cuando es verdadero, hace que Gateway emita solo los eventos personalizados del analizador de salida del agente en el flujo de invocación (descartando los marcos de la plataforma). Se conserva desde las características de agent.yaml en agentengine init.
  
  Marco string
  
  github_installation_id entero
  
  GithubInstallationID es la instalación de la aplicación GitHub propietaria del repositorio. Pertenece a ECP y se obtiene en cada solicitud GET de detalles (no se almacena en la base de datos de la puerta de enlace), por lo que funciona para espacios de trabajo creados antes de que existiera este campo. La interfaz de usuario lo necesita para mostrar las ramas del repositorio al editar la rama que se está siguiendo.
  
  gitops Objeto
  
  Ocultar atributos de gitops Mostrar atributos de gitops Objeto
  
  sucursal string
  
  referencia_de_conexión string
  
  github_installation_id integer(int64)
  
  ruta_del_manifiesto string
  
  Proveedor string
  
  repo_url string
  
  ID string
  
  Instancias Objeto
  
  El campo Instances informa sobre el número de instancias del espacio de trabajo (activas, en espera e iniciando), así como el tiempo de lectura obtenido de la celda OE del espacio de trabajo. No se muestra cuando OE no está disponible o el espacio de trabajo no se ejecuta en modo pool (p. ej., modo contenedor). Se omite deliberadamente cualquier nomenclatura de implementación interna: este es un campo visible para el cliente.
  
  Ocultar atributos de instancias Mostrar atributos de instancias Objeto
  
  Activo entero
  
  agrupada booleano
  
  standby entero
  
  Inicio entero
  
  invocaciones entero
  
  Métricas de ejecución en una ventana deslizante de 24h. Los cinco campos son punteros para que el cable pueda distinguir dos casos en los que la interfaz de usuario necesita renderizar de manera diferente: (a) la obtención de métricas OE falló (fallo suave: los cinco campos están ausentes), o (b) la ventana contiene cero invocaciones / ninguna ejecución completada (Invocaciones está establecido en 0 y los campos de latencia/tasa están ausentes). La interfaz de usuario distingue "—" de "0 invocaciones" mediante Invocaciones != nil.
  
  Idioma string
  
  última_invocación_en string(date-time)
  
  métricas_calculadas_en string(date-time)
  
  metrics_window_start string(date-time)
  
  Nombre string
  
  org_id string
  
  latencia p95_ms Número
  
  project_id string
  
  modo de liberación string
  
  ReleaseMode es la política de liberación de webhook propiedad de ECP ("push" | "tag-release" | "api-only"). Se obtiene en cada solicitud GET de detalles; no está presente cuando ECP no tiene valor o no está disponible.
  
  Estado string
  
  El estado es la señal activa/en pausa propiedad de ECP. La puerta de enlace la obtiene de ECP en cada solicitud GET de detalles; no se almacena localmente. No aparece cuando ECP no está disponible; la interfaz de usuario interpreta la ausencia como si el estado no estuviera en pausa.
  
  Los valores son active, paused, error, disconnected o deleting.
  
  subdirectorio string
  
  updated_date string
  
  ID del espacio de trabajo string
  
  nombre_del_espacio_de_trabajo string
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
401

application/json

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

No autorizado
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
500

application/json

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

Error interno del servidor
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

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces' \
 --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)

{
  "total": 42,
  "workspaces": [
    {
      "aer_http_endpoint": "string",
      "agent_card": {
        "a2a_allowed_callers": [
          "string"
        ],
        "a2a_enabled": true,
        "capabilities": [
          "string"
        ],
        "input_modes": [
          "string"
        ],
        "output_modes": [
          "string"
        ],
        "skills": [
          {
            "description": "string",
            "example_input": "string",
            "example_output": "string",
            "name": "string"
          }
        ],
        "summary": "string"
      },
      "agent_grpc_endpoint": "string",
      "agent_http_endpoint": "string",
      "auto_deploy": true,
      "completion_rate": 42.0,
      "created_date": "string",
      "current_deployment_id": "string",
      "current_payload_ref": "string",
      "description": "string",
      "features": {
        "guardrails": true,
        "memory": true,
        "playground": true,
        "use_custom_parser": true
      },
      "framework": "string",
      "github_installation_id": 42,
      "gitops": {
        "branch": "string",
        "connection_ref": "string",
        "github_installation_id": 42,
        "manifest_path": "string",
        "provider": "string",
        "repo_url": "string"
      },
      "id": "string",
      "instances": {
        "active": 42,
        "pooled": true,
        "standby": 42,
        "starting": 42
      },
      "invocations": 42,
      "language": "string",
      "last_invoked_at": "2026-05-04T09:42:00Z",
      "metrics_computed_at": "2026-05-04T09:42:00Z",
      "metrics_window_start": "2026-05-04T09:42:00Z",
      "name": "string",
      "org_id": "string",
      "p95_latency_ms": 42.0,
      "project_id": "string",
      "release_mode": "string",
      "status": "active",
      "subdirectory": "string",
      "updated_date": "string",
      "workspace_id": "string",
      "workspace_name": "string"
    }
  ]
}

Ejemplos de respuesta (200)

{
  "total": 42,
  "workspaces": [
    {
      "aer_http_endpoint": "string",
      "agent_card": {
        "a2a_allowed_callers": [
          "string"
        ],
        "a2a_enabled": true,
        "capabilities": [
          "string"
        ],
        "input_modes": [
          "string"
        ],
        "output_modes": [
          "string"
        ],
        "skills": [
          {
            "description": "string",
            "example_input": "string",
            "example_output": "string",
            "name": "string"
          }
        ],
        "summary": "string"
      },
      "agent_grpc_endpoint": "string",
      "agent_http_endpoint": "string",
      "auto_deploy": true,
      "completion_rate": 42.0,
      "created_date": "string",
      "current_deployment_id": "string",
      "current_payload_ref": "string",
      "description": "string",
      "features": {
        "guardrails": true,
        "memory": true,
        "playground": true,
        "use_custom_parser": true
      },
      "framework": "string",
      "github_installation_id": 42,
      "gitops": {
        "branch": "string",
        "connection_ref": "string",
        "github_installation_id": 42,
        "manifest_path": "string",
        "provider": "string",
        "repo_url": "string"
      },
      "id": "string",
      "instances": {
        "active": 42,
        "pooled": true,
        "standby": 42,
        "starting": 42
      },
      "invocations": 42,
      "language": "string",
      "last_invoked_at": "2026-05-04T09:42:00Z",
      "metrics_computed_at": "2026-05-04T09:42:00Z",
      "metrics_window_start": "2026-05-04T09:42:00Z",
      "name": "string",
      "org_id": "string",
      "p95_latency_ms": 42.0,
      "project_id": "string",
      "release_mode": "string",
      "status": "active",
      "subdirectory": "string",
      "updated_date": "string",
      "workspace_id": "string",
      "workspace_name": "string"
    }
  ]
}

Ejemplos de respuesta (400)

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

Ejemplos de respuesta (400)

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

Ejemplos de respuesta (401)

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

Ejemplos de respuesta (401)

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

Ejemplos de respuesta (500)

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

Ejemplos de respuesta (500)

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