Actualizar espacio de trabajo

PATCH /api/v1/projects/{id}/workspaces/{workspace_id}

Actualiza parcialmente un espacio de trabajo. El alcance del proyecto se define mediante el parámetro de ruta id. Los parches que solo modifican campos devuelven 204; un parche que solo modifica el estado (pausar/reanudar) es mutuamente excluyente con otros campos y devuelve 200 con el cuerpo de la aplicación de ECP (incluido cualquier warnings).

Parámetros de path

ID string Requerido

ID del proyecto
ID del espacio de trabajo string Requerido

ID del espacio de trabajo

application/json

Cuerpo Requerido

Campos a actualizar

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
auto_deploy booleano

AutoDeploy es un campo ECP a nivel de aplicación (no se guarda en la base de datos de la puerta de enlace); se reenvía tal cual al PATCH de la aplicación ECP.
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
gitops Objeto
Ocultar atributos de gitops Mostrar atributos de gitops Objeto
- sucursal string
- referencia_de_conexión string
- ruta_del_manifiesto string
- Proveedor string
- repo_url string
Nombre string
modo de liberación string

ReleaseMode es un campo ECP a nivel de aplicación (no se guarda en la base de datos de la puerta de enlace); se reenvía tal cual al parche de la aplicación ECP. Controla únicamente las compilaciones activadas por webhook; las versiones activadas por API están disponibles en todos los modos.
Estado string

El estado es una señal de pausa/reanudación ("activo" | "en pausa"). La puerta de enlace no lo almacena localmente; el controlador reenvía un parche que solo indica el estado directamente a ECP, que ejecuta pause-teardown / resume-redeploy.
subdirectorio string
nombre_del_espacio_de_trabajo string

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

Devuelto para parches de estado únicamente; redirigido desde ECP.
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- app_id string
- org_id string
- project_id string
- Estado string
- advertencias array[string]
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- app_id string
- org_id string
- project_id string
- Estado string
- advertencias array[string]
204

Devuelto para parches de actualización de campo.
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
404

application/json

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

No encontrado
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
413

application/json

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

Entidad de solicitud demasiado grande
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
429

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

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

Demasiadas peticiones
Atributo de ocultar encabezados Mostrar atributo de encabezados
- Después de reintento string
  
  Segundos de espera antes de volver a intentarlo
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
502

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

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

Fallo en el transporte de ECP o en la pausa de desmontaje.
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
503

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

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

Servicio no disponible
Atributo de ocultar encabezados Mostrar atributo de encabezados
- Después de reintento string
  
  Segundos de espera antes de volver a intentarlo
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

PARCHE /api/v1/projects/{id}/workspaces/{workspace_id}

curl \
 --request PATCH 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "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"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "string"
}'

Solicitar ejemplos

{
  "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"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "string"
}

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)

{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}

Ejemplos de respuesta (200)

{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}

Ejemplos de respuesta (400)

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

Ejemplos de respuesta (400)

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

Ejemplos de respuesta (404)

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

Ejemplos de respuesta (404)

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

Ejemplos de respuesta (413)

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

Ejemplos de respuesta (413)

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

Ejemplos de respuesta (429)

# Headers
Retry-After: string

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

Ejemplos de respuesta (429)

# Headers
Retry-After: string

# Payload
{
  "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
}

Ejemplos de respuesta (502)

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

Ejemplos de respuesta (502)

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

Ejemplos de respuesta (503)

# Headers
Retry-After: string

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

Ejemplos de respuesta (503)

# Headers
Retry-After: string

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