Atualizar espaço de trabalho

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

Atualiza parcialmente um espaço de trabalho. O escopo do projeto é suportado pelo parâmetro de caminho de ID de rota. Os patches somente de campo retornam 204; um patch somente de status (pausar/retomar) é mutuamente exclusivo com outros campos e retorna 200 com o corpo do aplicativo ECP (incluindo qualquer warnings).

parâmetros de caminho

  • id string Obrigatório

    ID do Projeto

  • workspace_id string Obrigatório

    ID do espaço de trabalho

aplicação/json

corpo, corpo Obrigatório

Campos a serem atualizados

  • Agent_card objeto
    Ocultar atributos do Agent_card Mostrar atributos do Agent_card objeto
    • a2a_allowed_callers array[string]

      A2AAllowedCallers restringe quais IDs de espaço de trabalho podem invocar esse agente por meio da A2A. Uma lista vazia significa que qualquer chamador é permitido.

    • a2a_enabled booleano

      A2AEnabled controla se esse agente é detectável para chamadas A2A.

    • capacidades array[string]
    • input_modes array[string]

      InputModes lista os tipos de MIME que o agente aceita (por exemplo, "text/plain", " aplicação/json").

    • output_modes array[string]

      OutputModes lista os tipos de MIME que o agente pode produzir.

    • habilidades array[objeto]

      As habilidades anunciam tarefas discretas que o agente pode executar.

      Ocultar atributos de habilidades Mostrar atributos de habilidades objeto
      • Descrição string
      • sample_input string
      • sample_output string
      • name string
    • Resumo string
  • auto_deploy booleano

    AutoDeploy é um campo de ECP no nível do aplicativo (não persistente no banco de dados do gateway); encaminhado literalmente para o aplicativo PATCH da ECP.

  • Descrição string
  • características objeto
    Ocultar atributos de funcionalidades Mostrar atributos de funcionalidades objeto
    • guardrails booleano
    • Memória booleano
    • Parque infantil booleano

      O Playground relata se a interface do usuário do playground está provisionada para o espaço de trabalho (nil/true = provisionado, comportamento de hoje). Quando falso, os chamadores usam a API de chamada diretamente.

    • use_custom_parser booleano

      UseCustomParser, quando verdadeiro, faz com que o Gateway emita apenas os eventos personalizados do analisador de saída do agente no fluxo de invocações (descartando armações da plataforma). Persistência dos recursos .yaml do agente na inicialização do agentengine.

  • Framework string
  • gitops objeto
    Ocultar atributos de gitops Mostrar atributos do gitops objeto
    • branch string
    • connection_ref string
    • manifest_path string
    • fornecedor string
    • repo_url string
  • name string
  • release_mode string

    ReleaseMode é um campo ECP no nível do aplicativo (não persistente no banco de dados do gateway); encaminhado literalmente para o aplicativo PATCH da ECP. Controla somente compilações acionadas por webhook - Versões acionadas por API estão disponíveis em todos os modo.

  • Status string

    O status é um sinal de pausa/retomada ("ativo" | "pausado"). O gateway não persiste localmente; o manipulador encaminha um patch somente de status diretamente para o ECP, que executa pause-teardown / resume-redeploy.

  • subdiretório string
  • workspace_name string

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

    Retornado para patches somente de status; proxy do ECP.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • app_id string
    • org_id string
    • PROJECT_ID string
    • Status string
    • avisos array[string]
    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • app_id string
    • org_id string
    • PROJECT_ID string
    • Status string
    • avisos array[string]
  • 204

    Retornado para patches de atualização de campo.

  • 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
  • 404

    Não encontrado

    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
  • 413

    Entidade solicitante muito grande

    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
  • 429

    Muitas solicitações

    Ocultar atributo de cabeçalhos Mostrar atributo de cabeçalhos
    • Tentar novamente depois string

      Segundos para esperar antes de tentar novamente

    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
  • 500

    Erro interno do servidor

    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

    Falha no transporte ou pausa-teardown do ECP.

    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
  • 503

    Serviço indisponível

    Ocultar atributo de cabeçalhos Mostrar atributo de cabeçalhos
    • Tentar novamente depois string

      Segundos para esperar antes de tentar novamente

    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
PATCH /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"
}'
Exemplos de solicitação 
{
  "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"
}
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) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}
Exemplos de resposta (200) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (500) 
{
  "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
}
Exemplos de resposta (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
Exemplos de resposta (503) 
# Headers
Retry-After: string

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