Stop Bulkjob

Stop an active Enhance Bulkjob

Request

Authentication
`token`query	Diffbot API token, supplied as the `token` query parameter on every request. `<DIFFBOT_TOKEN>` Cache and insert token into example requests (15d expiry)

Path parameters
`bulkjobId`string required	Enhance Bulkjob ID

Example request

bash

curl --request GET \
  --url 'https://kg.diffbot.com/kg/v3/enhance/bulk/<bulkjobId>/stop?token=<DIFFBOT_TOKEN>' \
  --header 'Accept: application/json'

Response

200Bulkjob status after the stop request
`status`string	Bulkjob recovery status
`message`string	Bulkjob recovery status message

400Invalid bulkjobId
`code`integer (int32)	Status code (same as the HTTP status code)
`message`string	Status message
`request_ctx`object	Request context
`↳ query`object \| object \| string	Submitted query
`↳ type`string	Diffbot entity type
`↳ name`string[]	Name of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ url`string[]	Origin or homepage URI of entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ location`string	Location of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ ip`string	IP address of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ phone`string	Phone of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ description`string	Description of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ email`string[]	Email of the entity to enhance. Parameter can be used only with type `Person`
`↳ employer`string	Employer of the entity to enhance. Parameter can be used only with type `Person`
`↳ title`string	Title of the entity to enhance. Parameter can be used only with type `Person`
`↳ school`string	School of the entity to enhance. Parameter can be used only with type `Person`
`↳ query_ctx`object	Query context. Example: submitted query parameters etc.
`bulkjobStatus`object	Bulkjob status
`↳ job_id`string	Bulkjob Id
`↳ name`string	Bulkjob name
`↳ refresh`boolean	Is Refresh enabled for this job?
`↳ search`string	Is Search enabled for this job?
`↳ message`string	Bulkjob status message
`↳ jobs_total`integer (int32)	Number of jobs in bulkjob
`↳ jobs_completed`integer (int32)	Number of jobs completed in bulkjob.
`↳ status`string	Status of Bulkjob. One of {NOT_STARTED, IN_PROCESS, COMPLETE, COMPLETE_WITH_FAILURES, STOPPED, ERROR_FINALIZING, UNKNOWN}
`↳ estimate_remaining_time`integer (int64)	Estimated remaining time for bulkjob to complete (in seconds). `null` if job is completed or not started.
`↳ submit_time_ms`integer (int64)	Bulkjob submit time
`↳ start_time_ms`integer (int64)	Bulkjob start time
`↳ completed_time_ms`integer (int64)	Bulkjob completed time
`↳ total_results`integer (int32)	Total results
`↳ bulkjobId`string
`↳ totalJobs`integer (int32)
`↳ finishedJobs`integer (int32)
`↳ estimateRemainingTimeSec`integer (int64)
`↳ submitTimeMs`integer (int64)
`↳ startTimeMs`integer (int64)
`↳ completedTimeMs`integer (int64)
`↳ totalResults`integer (int32)
`↳ fileSizeBytes`integer (int64)	Size of download file in bytes
`↳ reports`object[]	Coverage reports generated for this bulkjob
`↳ reportId`string	Coverage Report ID
`↳ status`string	Status of report generation. One of {NOT_STARTED, IN_PROCESS, COMPLETE, UNKNOWN}
`↳ format`string	Export format
`↳ spec`string	The spec defines the columns to export. This is applicable for csv, xls and xslx formats. Export spec specifies how to export the entity JSON to a csv. A simple export spec looks like `name;summary`. To specify more complex export spec, including specifying how many of a list of `industries` to return, or the ideal `employment` record, see Exporting Columnar Format and JsonPath Filtering.
`↳ exportfile`string
`↳ exportSeparator`string	Separator for multi-value fields when exporting columnar results
`↳ filter`string	Semi-colon separated path filter to filter response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as `$.name;$.locations.country.name`. For more advanced options, see JsonPath Filtering for syntax.
`↳ onlyMatches`boolean	Return only records that have a match
`error`boolean	`true` if error

401Token not specified or other client errors
`requestId`string	Identifier of the rejected request, also returned in the `X-Diffbot-RequestId` header
`code`integer (int32)	Status code (same as the HTTP status code)
`message`string	Status message

404Bulkjob not found
`code`integer (int32)	Status code (same as the HTTP status code)
`message`string	Status message
`request_ctx`object	Request context
`↳ query`object \| object \| string	Submitted query
`↳ type`string	Diffbot entity type
`↳ name`string[]	Name of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ url`string[]	Origin or homepage URI of entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ location`string	Location of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ ip`string	IP address of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ phone`string	Phone of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ description`string	Description of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ email`string[]	Email of the entity to enhance. Parameter can be used only with type `Person`
`↳ employer`string	Employer of the entity to enhance. Parameter can be used only with type `Person`
`↳ title`string	Title of the entity to enhance. Parameter can be used only with type `Person`
`↳ school`string	School of the entity to enhance. Parameter can be used only with type `Person`
`↳ query_ctx`object	Query context. Example: submitted query parameters etc.
`bulkjobStatus`object	Bulkjob status
`↳ job_id`string	Bulkjob Id
`↳ name`string	Bulkjob name
`↳ refresh`boolean	Is Refresh enabled for this job?
`↳ search`string	Is Search enabled for this job?
`↳ message`string	Bulkjob status message
`↳ jobs_total`integer (int32)	Number of jobs in bulkjob
`↳ jobs_completed`integer (int32)	Number of jobs completed in bulkjob.
`↳ status`string	Status of Bulkjob. One of {NOT_STARTED, IN_PROCESS, COMPLETE, COMPLETE_WITH_FAILURES, STOPPED, ERROR_FINALIZING, UNKNOWN}
`↳ estimate_remaining_time`integer (int64)	Estimated remaining time for bulkjob to complete (in seconds). `null` if job is completed or not started.
`↳ submit_time_ms`integer (int64)	Bulkjob submit time
`↳ start_time_ms`integer (int64)	Bulkjob start time
`↳ completed_time_ms`integer (int64)	Bulkjob completed time
`↳ total_results`integer (int32)	Total results
`↳ bulkjobId`string
`↳ totalJobs`integer (int32)
`↳ finishedJobs`integer (int32)
`↳ estimateRemainingTimeSec`integer (int64)
`↳ submitTimeMs`integer (int64)
`↳ startTimeMs`integer (int64)
`↳ completedTimeMs`integer (int64)
`↳ totalResults`integer (int32)
`↳ fileSizeBytes`integer (int64)	Size of download file in bytes
`↳ reports`object[]	Coverage reports generated for this bulkjob
`↳ reportId`string	Coverage Report ID
`↳ status`string	Status of report generation. One of {NOT_STARTED, IN_PROCESS, COMPLETE, UNKNOWN}
`↳ format`string	Export format
`↳ spec`string	The spec defines the columns to export. This is applicable for csv, xls and xslx formats. Export spec specifies how to export the entity JSON to a csv. A simple export spec looks like `name;summary`. To specify more complex export spec, including specifying how many of a list of `industries` to return, or the ideal `employment` record, see Exporting Columnar Format and JsonPath Filtering.
`↳ exportfile`string
`↳ exportSeparator`string	Separator for multi-value fields when exporting columnar results
`↳ filter`string	Semi-colon separated path filter to filter response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as `$.name;$.locations.country.name`. For more advanced options, see JsonPath Filtering for syntax.
`↳ onlyMatches`boolean	Return only records that have a match
`error`boolean	`true` if error

500Internal Server Error
`code`integer (int32)	Status code (same as the HTTP status code)
`message`string	Status message
`request_ctx`object	Request context
`↳ query`object \| object \| string	Submitted query
`↳ type`string	Diffbot entity type
`↳ name`string[]	Name of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ url`string[]	Origin or homepage URI of entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ location`string	Location of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ ip`string	IP address of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ phone`string	Phone of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ description`string	Description of the entity to enhance. Parameter can be used with types `Person` and `Organization`
`↳ email`string[]	Email of the entity to enhance. Parameter can be used only with type `Person`
`↳ employer`string	Employer of the entity to enhance. Parameter can be used only with type `Person`
`↳ title`string	Title of the entity to enhance. Parameter can be used only with type `Person`
`↳ school`string	School of the entity to enhance. Parameter can be used only with type `Person`
`↳ query_ctx`object	Query context. Example: submitted query parameters etc.
`bulkjobStatus`object	Bulkjob status
`↳ job_id`string	Bulkjob Id
`↳ name`string	Bulkjob name
`↳ refresh`boolean	Is Refresh enabled for this job?
`↳ search`string	Is Search enabled for this job?
`↳ message`string	Bulkjob status message
`↳ jobs_total`integer (int32)	Number of jobs in bulkjob
`↳ jobs_completed`integer (int32)	Number of jobs completed in bulkjob.
`↳ status`string	Status of Bulkjob. One of {NOT_STARTED, IN_PROCESS, COMPLETE, COMPLETE_WITH_FAILURES, STOPPED, ERROR_FINALIZING, UNKNOWN}
`↳ estimate_remaining_time`integer (int64)	Estimated remaining time for bulkjob to complete (in seconds). `null` if job is completed or not started.
`↳ submit_time_ms`integer (int64)	Bulkjob submit time
`↳ start_time_ms`integer (int64)	Bulkjob start time
`↳ completed_time_ms`integer (int64)	Bulkjob completed time
`↳ total_results`integer (int32)	Total results
`↳ bulkjobId`string
`↳ totalJobs`integer (int32)
`↳ finishedJobs`integer (int32)
`↳ estimateRemainingTimeSec`integer (int64)
`↳ submitTimeMs`integer (int64)
`↳ startTimeMs`integer (int64)
`↳ completedTimeMs`integer (int64)
`↳ totalResults`integer (int32)
`↳ fileSizeBytes`integer (int64)	Size of download file in bytes
`↳ reports`object[]	Coverage reports generated for this bulkjob
`↳ reportId`string	Coverage Report ID
`↳ status`string	Status of report generation. One of {NOT_STARTED, IN_PROCESS, COMPLETE, UNKNOWN}
`↳ format`string	Export format
`↳ spec`string	The spec defines the columns to export. This is applicable for csv, xls and xslx formats. Export spec specifies how to export the entity JSON to a csv. A simple export spec looks like `name;summary`. To specify more complex export spec, including specifying how many of a list of `industries` to return, or the ideal `employment` record, see Exporting Columnar Format and JsonPath Filtering.
`↳ exportfile`string
`↳ exportSeparator`string	Separator for multi-value fields when exporting columnar results
`↳ filter`string	Semi-colon separated path filter to filter response json. You can use a simple dot notation `skills.name` or a JsonPath expression such as `$.name;$.locations.country.name`. For more advanced options, see JsonPath Filtering for syntax.
`↳ onlyMatches`boolean	Return only records that have a match
`error`boolean	`true` if error

Authentication

Custom API

Manage a Crawl JobGET

Bulk Enhance API

Example

API Definition

Request

Example request

Response

Stop Bulkjob ​

Example ​

API Definition

Request

Example request

Response

Stop Bulkjob

Example