Mova um portfólio em etapas compreensíveis

O trabalho em lote foi pensado para que nada mude até uma pessoa ver e aprovar o plano exato. Você precisa de uma conexão com portfolios:read, portfolios:write, portfolios:execute e approvals:request, além das permissões de casas para as ações planejadas.

Importe o inventário

POST /workspaces/{id}/portfolios aceita um CSV com o cabeçalho item_key,domain,source_url,world_handle,template_id,content_language ou os mesmos campos como items[], até 1000 linhas, com preserve_existing_mx: true. Cada linha é verificada sozinha: domínios são normalizados, duplicatas e URLs inseguras são bloqueadas e o texto encontrado em uma origem é guardado como dado não confiável. Nada mais acontece ainda.

Prepare e leia um plano de teste

POST /workspaces/{id}/bulk-plans recebe as ações desejadas (create_draft, apply_import, set_dna, publish e as etapas de domínio), limites de orçamento e rollout_batches como [5, 95]: um lote canário de cinco e depois o resto. A resposta é um manifesto imutável e o seu plan_hash. Leia com GET /bulk-plans/{plan_id}: cada etapa por item, o que mudaria e como pode ser revertido. Etapas de DNS só mexem em registros do site e mantêm os de e-mail. Planos expiram em 24 horas.

Peça a aprovação do proprietário

POST /workspaces/{id}/approvals vincula o plan_hash exato, os limites e uma validade, e devolve uma approval_url. Só um proprietário pode decidir, no navegador, depois de entrar de novo e confirmar o hash que viu. Um plano alterado nunca reaproveita uma aprovação, e um token nunca pode aprovar.

Execute, acompanhe e conduza

• POST /bulk-plans/{plan_id}/execute com o plan_hash e o approval_id inicia a única execução que essa aprovação permite. O lote canário roda primeiro; continue inicia o resto.
• Acompanhe GET /bulk-runs/{run_id} ou os webhooks job.updated e job.item.updated.
• pause, resume, cancel e retry (etapas concluídas não se repetem) conduzem a execução. rollback desfaz o que a execução escreveu enquanto isso continuar inalterado.

Registros de domínio, mensagens enviadas e propagação de DNS já ocorrida não são reversíveis e nunca aparecem como revertidos. Revogar o token interrompe o trabalho novo na próxima etapa.

O que funciona hoje

Importação, validação, planos de teste e aprovações funcionam em todos os ambientes. A execução funciona de ponta a ponta com provedores simulados de domínio, DNS e certificado em desenvolvimento e testes, e continua desligada em produção até existirem conexões reais com provedores. GET /capabilities informa isso como bulk.execute.