BulkOperation object

An asynchronous long-running operation to fetch data in bulk.

Bulk operations are created using the bulkOperationRunQuery mutation. After they are created, clients should poll the status field for updates. When COMPLETED, the url field contains a link to the data in JSONL format.

See the bulk operations guide for more details.

On this page

Fields

  • completedAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
    When the bulk operation was successfully completed.
  • createdAt ([DateTime!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
    When the bulk operation was created.
  • errorCode ([BulkOperationErrorCode](https://shopify.dev/docs/admin-api/graphql/reference/bulk-operations/bulkoperationerrorcode))
    Error code for failed operations.
  • fileSize ([UnsignedInt64](https://shopify.dev/docs/admin-api/graphql/reference/scalar#unsignedint64-2021-01))
    File size in bytes of the file in the url field.
  • id ([ID!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#id-2021-01))
    Globally unique identifier.
  • objectCount ([UnsignedInt64!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#unsignedint64-2021-01))
    The running count of all objects processed. For example, when fetching all products and their variants, this field counts both products and variants. This field can be used to track operation progress.
  • partialDataUrl ([URL](https://shopify.dev/docs/admin-api/graphql/reference/scalar#url-2021-01))
    URL to partial/incomplete response data (in JSONL format) returned by a failed operation. Expires one week after the operation fails. Returns null when there’s no data available.
  • query ([String!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
    GraphQL query document specified in bulkOperationRunQuery.
  • rootObjectCount ([UnsignedInt64!](https://shopify.dev/docs/admin-api/graphql/reference/scalar#unsignedint64-2021-01))
    The running count of all objects processed at the root of the query. For example, when fetching all products and their variants, this field counts only products. This field can be used to track operation progress.
  • status ([BulkOperationStatus!](https://shopify.dev/docs/admin-api/graphql/reference/bulk-operations/bulkoperationstatus))
    Status of the bulk operation.
  • url ([URL](https://shopify.dev/docs/admin-api/graphql/reference/scalar#url-2021-01))
    URL to the response data in JSONL format. Expires one week after the operation completes.

Types that return BulkOperation

  • [QueryRoot.currentBulkOperation](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/queryroot#currentbulkoperation-2021-01)

Mutations for BulkOperation

Implements

  • [Node](https://shopify.dev/docs/admin-api/graphql/reference/common-objects/node)