Mueve una cartera en pasos comprensibles

El trabajo masivo está pensado para que nada cambie hasta que una persona haya visto y aprobado el plan exacto. Necesitas una conexión con portfolios:read, portfolios:write, portfolios:execute y approvals:request, además de los permisos de casas para las acciones que planees.

Importa el inventario

POST /workspaces/{id}/portfolios acepta un CSV con la cabecera item_key,domain,source_url,world_handle,template_id,content_language o los mismos campos como items[], hasta 1000 filas, con preserve_existing_mx: true. Cada fila se comprueba por separado: los dominios se normalizan, los duplicados y las URL inseguras se bloquean y el texto encontrado en un origen se guarda como dato no confiable. Todavía no ocurre nada más.

Prepara y lee un plan de prueba

POST /workspaces/{id}/bulk-plans recibe las acciones que quieres (create_draft, apply_import, set_dna, publish y los pasos de dominio), límites de presupuesto y rollout_batches como [5, 95]: un lote canario de cinco y después el resto. La respuesta es un manifiesto inmutable y su plan_hash. Léelo con GET /bulk-plans/{plan_id}: cada paso por elemento, qué cambiaría y cómo se puede revertir. Los pasos DNS solo tocan registros del sitio web y dejan intactos los de correo. Los planes caducan a las 24 horas.

Pide la aprobación del propietario

POST /workspaces/{id}/approvals vincula el plan_hash exacto, los límites y una caducidad, y devuelve una approval_url. Solo un propietario puede decidirla, en el navegador, tras iniciar sesión de nuevo y confirmar el hash que vio. Un plan modificado nunca reutiliza una aprobación y un token nunca puede aprobar.

Ejecuta, observa y dirige

• POST /bulk-plans/{plan_id}/execute con el plan_hash y el approval_id inicia la única ejecución que permite esa aprobación. Primero va el lote canario; continue lanza el resto.
• Observa GET /bulk-runs/{run_id} o los webhooks job.updated y job.item.updated.
• pause, resume, cancel y retry (los pasos terminados no se repiten) dirigen la ejecución. rollback deshace lo que escribió la ejecución mientras siga sin cambios.

Los registros de dominios, los mensajes enviados y la propagación DNS ya ocurrida no son reversibles y nunca se presentan como revertidos. Revocar el token detiene el trabajo nuevo en el siguiente paso.

Qué funciona hoy

La importación, la validación, los planes de prueba y las aprobaciones funcionan en todos los entornos. La ejecución funciona de principio a fin con proveedores de dominio, DNS y certificados simulados en desarrollo y pruebas, y sigue desactivada en producción hasta que haya conexiones reales con proveedores. GET /capabilities lo indica como bulk.execute.