Use Magento 2 asynchronous and bulk REST endpoints for high-volume catalog operations

domain: magento.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Prefix any standard synchronous REST endpoint with `/async/V1/` for single async calls, or `/async/bulk/V1/` for batch operations; for example, bulk product upsert becomes `PUT /<store_code>/async/bulk/V1/products`.
  2. Send an array of objects in the request body; the bulk endpoint splits the array into individual messages and writes each to the message queue, returning a `bulk_uuid` and array of `request_items`.
  3. Ensure RabbitMQ (or an alternative message broker) is installed and configured; start the async consumer with `bin/magento queue:consumers:start async.operations.all`.
  4. Poll operation status via `GET /V1/bulk/{bulk_uuid}/status` for a summary, or `GET /V1/bulk/{bulk_uuid}/operation-status/{status}` to count operations in a specific state (e.g., 4 = complete, 2 = failed).
  5. For failed operations, retrieve error details from the operation status response and re-submit corrected records as a new bulk request.
  6. Scope bulk requests to a specific store view by including the store code in the route (e.g., `PUT /en_US/async/bulk/V1/products`) to avoid updating the default scope unintentionally.

Known gotchas

Related routes

Configure Adobe Commerce (Magento) async bulk REST API for high-volume product attribute updates with error handling and retry
Adobe Commerce / Magento async API · 6 steps · unrated
Implement an Adobe Commerce (Magento 2) custom REST API endpoint with authentication and rate limiting for a headless B2B mobile app
Adobe Commerce custom REST API · 6 steps · unrated
Handle the asynchronous 202/Content-Location/X-Progress polling pattern for long-running FHIR Bulk Data and DEQM operations
build.fhir.org · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans