Run a Shopify Admin GraphQL bulk operation (bulkOperationRunQuery) and parse the resulting JSONL output

In-depth guide

Steps

1. Call the bulkOperationRunQuery Admin GraphQL mutation with a query string that wraps your data query in a bulkOperation context; the query must reference only connection fields and use the implicit __parent_id mechanism for nested resources
2. Poll the currentBulkOperation query to check status (CREATED, RUNNING, COMPLETED, FAILED, CANCELED); poll on a reasonable interval (e.g., every 5 seconds for small operations, longer for large ones)
3. When status is COMPLETED, retrieve the url field from currentBulkOperation — this is a short-lived signed URL to a JSONL file on Shopify's CDN; download it promptly before the URL expires
4. Parse the JSONL file line by line; each line is a JSON object representing one node from the query; nested resources include a __parentId field linking them to their parent node — reassemble the tree if needed
5. Handle partial failures: if status is FAILED check the errorCode and partialDataUrl; partial data may still be usable depending on the error
6. For bulk mutations use bulkOperationRunMutation with a JSONL input file uploaded via stagedUploadsCreate; the flow is upload JSONL → get staged upload URL → POST file → call bulkOperationRunMutation with the staged upload URL