Empieza por el código de error y X-Request-ID; después comprueba entorno, proyecto y estado persistente del Job antes de reintentar.
Identificar la petición
Guarda X-Request-ID, job_id, task_id y file_id. Permiten separar problemas de transporte de fallos de motor o rechazo de capability.
Cargas directas
Si falla una carga desde navegador, revisa caducidad de URL firmada, Content-Type, tamaño declarado y CORS del almacenamiento. Los bytes no deben atravesar /v1/convert.
Jobs y conversiones
Inspecciona Task attempts y el code. No reintentes a ciegas INVALID_CONVERSION_SETTINGS o CONVERSION_OUTPUT_INVALID; corrige petición o archivo.
Escalar con contexto
Incluye X-Request-ID, entorno, hora UTC, par de formatos y etapa que falló. Nunca envíes una API key completa ni un documento sensible por un canal no aprobado.