Abort a Job

If you abort a job, Salesforce doesn’t process the job.

URI: /services/data/vXX.X/jobs/ingest/jobID

Availability: This resource is available in API version 41.0 and later.

Formats: JSON

HTTP Method: PATCH

Authentication: Authorization: Bearer token

Parameters: None.

Request Body

PropertyTypeDescriptionRequired or Optional
stateJobStateEnumThe state to update the job to. Use Aborted to abort a job.Required

Response Body

PropertyTypeDescription
apiVersionstringThe API version that the job was created in.
assignmentRuleIdidThe ID of the assignment rule. This property is only shown if an assignment rule is specified when the job is created.
columnDelimiterColumnDelimiterEnumThe column delimiter used for CSV job data. Values include:
  • BACKQUOTE—backquote character (`)
  • CARET—caret character (^)
  • COMMA—comma character (,) which is the default delimiter
  • PIPE—pipe character (|)
  • SEMICOLON—semicolon character (;)
  • TAB—tab character
concurrencyModeConcurrencyModeEnumFor future use. How the request was processed. Currently only parallel mode is supported. (When other modes are added, the mode will be chosen automatically by the API and will not be user configurable.)
contentTypeContentTypeThe format of the data being processed. Only CSV is supported.
contentUrlURLThe URL to use for Upload Job Data requests for this job. Only valid if the job is in Open state.
createdByIdstringThe ID of the user who created the job.
createdDatedateTimeThe date and time in the UTC time zone when the job was created.
externalIdFieldNamestringThe name of the external ID field for an upsert.
idstringUnique ID for this job.
jobTypeJobTypeEnumThe job’s type. Values include:
  • BigObjectIngest—BigObjects job
  • Classic—Bulk API 1.0 job
  • V2Ingest—Bulk API 2.0 job
lineEndingLineEndingEnumThe line ending used for CSV job data. Values include:
  • LF—linefeed character
  • CRLF—carriage return character followed by a linefeed character
objectstringThe object type for the data being processed. Empty for jobs created with the consentImport operation.
operation The processing operation for the job. Values include:
  • insert
  • delete
  • hardDelete
  • update
  • upsert
  • refresh
  • consentImport
stateJobStateEnumThe current state of processing for the job. Values include:
  • Open—The job has been created, and data can be added to the job.
  • UploadComplete—No new data can be added to this job. You can’t edit or save this job, as Salesforce is processing it.
  • Aborted—The job has been aborted. You can abort a job if you created it or if you have the “Manage Data Integrations” permission.
  • JobComplete—The job was processed by Salesforce.
  • Failed—Some records in the job failed. Job data that was successfully processed isn’t rolled back.
systemModstampdateTimeDate and time in the UTC time zone when the job finished.