Skip to main content
Bulkgrid exposes explicit endpoints for retrying and cancelling runs.

Retry a run

The API also supports a payload with a urls array for targeted retry behavior when appropriate. Use retry when:
  • the run failed for transient reasons
  • individual URLs should be retried
  • your application can safely tolerate repeated processing

Cancel a run

Expected success response:

When to retry vs cancel

Retry when the work is still useful and failure appears recoverable. Cancel when:
  • the request is obsolete
  • the customer changed scope
  • downstream systems no longer need the output
  • the run is consuming resources you no longer want to spend

Operational guidance

  • do not blindly retry permanent failures
  • log last_error, error_code, and run status history
  • make retry decisions in your backend, not from browser clients