Atualize campos personalizados e janelas de manutenção, execute automação e tente gravar novamente com segurança.
A API e o MCP suportam trabalhos enfileirados, energia agendada, desinstalação de agente, diagnóstico de endpoint, cancelamento de comandos e políticas de patch de terceiros. Reutilize chaves de idempotência e inspecione recibos. Credenciais temporárias de administrador são retornadas uma vez. O monitoramento de tráfego requer direito existente; faturamento permanece no aplicativo.
Verifique suas permissões.
As predefinições selecionam recursos individuais; elas não alteram o nível de acesso. Novas credenciais em Configurações usam FullAccess por padrão, mas somente os recursos selecionados são permitidos. Credenciais mais antigas, como ReadWrite, permitem alterações aprovadas em campos personalizados e janelas de manutenção. Automação e controle de dispositivos exigem FullAccess, além de seus recursos específicos. Verifique GET e /v1/operations/capabilities antes de gravar. O escopo da empresa e as permissões do proprietário atual ainda se aplicam.
Evite sobrescrever outra alteração.
Leia o campo personalizado e sua versão. Envie seu novo valor e a versão lida para PATCH /v1/custom-fields/{fieldId}.. Um erro 409 version_conflict significa que alguém já o alterou. Leia-o novamente e verifique se sua atualização ainda é apropriada.
Tente novamente com segurança.
Para POST /v1/maintenance-windows, envie um cabeçalho Idempotency-Key. Após um resultado incerto, repita a mesma chave e corpo para recuperar a janela original em vez de criar uma duplicata. Um corpo alterado com a mesma chave é rejeitado. DELETE /v1/maintenance-windows/{windowId} cancela uma janela.
Acompanhe os recibos de ação.
As gravações de automação e gerenciamento usam idempotencyKey no corpo JSON e retornam um recibo de operação. Completed significa que o manipulador de requisições terminou; verifique o resultado ou a execução do domínio para saber se o dispositivo concluiu o trabalho. Para OutcomeUnknown, inspecione o recibo e o estado atual antes de decidir o que fazer. Nunca reenvie automaticamente com uma nova chave: a ação pode ser executada duas vezes.