BulkOperation object

Version 2020-01 (Release candidate)

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.

Fields

completedAt (DateTime)

When the bulk operation was successfully completed.

createdAt (DateTime!)

When the bulk operation was created.

errorCode (BulkOperationErrorCode)

Error code for failed operations.

fileSize (UnsignedInt64)

File size in bytes of the file in the url field.

id (ID!)

Globally unique identifier.

objectCount (UnsignedInt64!)

The running count of objects processed. This can be used to track operation progress.

partialDataUrl (URL)

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!)

GraphQL query document specified in bulkOperationRunQuery.

status (BulkOperationStatus!)

Status of the bulk operation.

url (URL)

URL to the response data in JSONL format. Expires one week after the operation completes.

Types that return BulkOperation

Mutations for BulkOperation

bulkOperationCancel

Starts the cancelation process of a running bulk operation.

There may be a short delay from when a cancelation starts until the operation is actually canceled.

bulkOperationRunQuery

Creates and runs a bulk operation query.

See the bulk operations guide for more details.

Implements

Version 2019-10 (Latest)

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.

Fields

completedAt (DateTime)

When the bulk operation was successfully completed.

createdAt (DateTime!)

When the bulk operation was created.

errorCode (BulkOperationErrorCode)

Error code for failed operations.

fileSize (UnsignedInt64)

File size in bytes of the file in the url field.

id (ID!)

Globally unique identifier.

objectCount (UnsignedInt64!)

The running count of objects processed. This can be used to track operation progress.

partialDataUrl (URL)

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!)

GraphQL query document specified in bulkOperationRunQuery.

status (BulkOperationStatus!)

Status of the bulk operation.

url (URL)

URL to the response data in JSONL format. Expires one week after the operation completes.

Types that return BulkOperation

Mutations for BulkOperation

bulkOperationCancel

Starts the cancelation process of a running bulk operation.

There may be a short delay from when a cancelation starts until the operation is actually canceled.

bulkOperationRunQuery

Creates and runs a bulk operation query.

See the bulk operations guide for more details.

Implements

Sign up for a Partner account to get started.

Sign up