Skip to main content
Operations affecting more than 200 sites are automatically queued for background processing. This prevents timeouts and provides progress monitoring for large operations.

What You’ll Learn

  • Understanding batch thresholds and affected abilities
  • Reading immediate vs. queued response patterns
  • Monitoring batch job status
  • Handling errors in batch operations

Batch Threshold

The default threshold is 200 sites. Operations below this threshold execute synchronously and return results immediately.

Affected Abilities

These abilities support batch queuing:

Response Patterns

Immediate Response (≤200 sites)

Queued Response (>200 sites)

mainwp/get-batch-job-status-v1

Retrieves the current status of a queued batch operation. Method: POST

Input Parameters

Response

Status Values

Polling Workflow

Job Lifecycle

Error Handling

When a batch job encounters errors, individual failures are recorded while the job continues processing remaining items. Check the errors array in the status response for details:
Jobs with errors complete with status: "completed" if any operations succeeded, or status: "failed" if all operations failed.