Import-Export

Discard a finished dry run

Changed on

Discards a dry run that has finished (COMPLETED), so it is no longer offered for import. The job becomes CANCELLED and GET /v1/entity:import:latest stops returning it as ready. For a file that requires a dry run (more than 50 rows), an import passing it as dry_run_job_id then fails with dry_run_required. The dry run wrote nothing, and its report stays available.

Only the user who ran the dry run can discard it (403 otherwise). Idempotent - discarding an already discarded dry run answers 200. A running dry run is stopped with POST /v1/entity:abortImport instead.

post/v1/entity:discardImport

Request

  • Base URL
    https://entity.sls.epilot.io
  • URL
    https://entity.sls.epilot.io/v1/entity:discardImport
  • Auth
    • HTTP bearer
    • or API key in header x-epilot-org-id

Query parameters

job_idstring required

The unique identifier of the import job.

Example:abc123

The ID of the dry run to discard.

schemastring required

Slug of the schema of the dry run, used to authorize the caller.

Response

The dry run is discarded.

statusstring

CANCELLED

jobPollIdstring

Changes