Salesforce Docs Portal

Delete a Job

To delete, a job must have a state of UploadComplete, JobComplete, Aborted, or Failed. When you delete a job, the stored job data is also deleted and its metadata is removed.

  • URI

    • : /api/v1/ingest/jobs/{id}

  • Available since release

    • : Data 360 v1.0, Salesforce v51.0

  • Formats

    • : JSON

  • HTTP methods

    • : DELETE

  • Authentication

    • : Authorization: Bearer {access_token}

  • Request body

    • : None required.

  • Request parameters

    • :
      Parameter Description
      id The job id that is returned in the response body from the Create a Job request.

  • Response body

    • : Returns a status code of 204 (No Content), which indicates that the job was successfully deleted.

Example

curl --location --request DELETE \
'https://{instance_url}/api/v1/ingest/jobs/{id}' \
--header 'Authorization: Bearer {access_token}'

HTTP/1.1 204 No Content

Usage Notes

When a job is deleted, job data stored by Salesforce is also deleted and job metadata information is removed. You can no longer discover the job in Get Job Info or Get All Jobs.

If your data contains special characters, make sure to enclose it in quotation marks.