Fetch Background Job

The Background job api gives you information about a background job that has been scheduled manually, as part of a bulk api request or through some other workflow.

The _data field returns meta information around the job itself.
The _meta field has extra information like

bjEntryCompletionStatusVsCount - count of all the backgroundjob entries grouped by their completion status.

INVALID - This completionStatus indicates that the entry was not valid. So it was not processed
NOT_STARTED - This completionStatus indicates that the background job entry is yet to be processed
SUCCESS - This completionStatus indicates that the background job entry has been processed successfully
ERROR - This completionStatus indicates that the background job entry has been processed but resulted in an error result

Background Job Examples

If you use a bulk api like
PATCH /v1/ext/procedure/lead/process
the api will internally schedule a background job to process the entries provided to the bulk api. The response of the api will look something like this:

{
  "_data": {
    "id": "19632427-908f-4bf3-a6f5-69b9a0bbfc63",
    "createdAt": 1617966536211,
    "updatedAt": 1617966536211,
    "completionStatus": "IN_PROGRESS",
    "statusMessage": null,
    "startedAt": 1617966536210,
    "completedAt": 0,
    "team": "d3e64510-b75a-43a0-8ae5-dde78dac56c0",
    "type": "3ae1c371-9a3b-4c06-8090-42fea6c4df36"
  }
}

The id - 19632427-908f-4bf3-a6f5-69b9a0bbfc63 in the response represnts the id of a background job

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "_data": { "id": "19632427-908f-4bf3-a6f5-69b9a0bbfc63", "createdAt": 1617966536211, "updatedAt": 1617966536211, "startedAt": 1617966536210, "team": "d3e64510-b75a-43a0-8ae5-dde78dac56c0", "type": "bulk_api_job" }, "_meta": { "bjEntryCompletionStatusVsCount": { "INVALID": 100, "NOT_STARTED": 120, "SUCCESS": 389, "ERROR": 3 } } }

Background Job Examples

Request

Responses

Fetch Background Job

Background Job Examples#

Request

Responses

Background Job Examples