Skip to main content
This schema describes objects returned by the Background Job endpoints.
A background job that can be used to perform long-running tasks

Fields

FieldTypeRequiredDescription
idstringYesUnique identifier for the background job (read-only)
workspace_idstring (uuid)YesWorkspace ID (read-only)
user_idstring (uuid), nullableNoThe id of the user that triggered the action that created the job (read-only)
typestringYesType of background job. Possible values: move-leads (Move Leads), import-leads (Import Leads), export-leads (Export Leads), update-warmup-accounts (Update Warmup Accounts), rename-variable (Rename Variable)
entity_idstring (uuid), nullableNoThe id of the entity that the job is related to
entity_typestringNoType of entity. Possible values: list (The entity is a lead list), campaign (The entity is a campaign), workspace (The entity is a workspace)
dataobjectNoData about the job, used to store any additional information we need to process the job
progressnumberYesProgress of the job as a percentage (from 0 to 100)
statusstringYesJob status. Possible values: pending (The background job is waiting in the queue to be processed), in-progress (The background job is being processed), success (The background job has been successfully processed), failed (The background job has failed)
created_atstringYesTimestamp when the job was created
updated_atstringYesTimestamp when the job was last updated