---
title: "Cancel a data transfer"
method: DELETE
path: "/transfer"
tags: ["transfer"]
---

# Cancel a data transfer

`DELETE /transfer`

## Request body

- DeleteTransferRequest
  - `transferId` string, required — id of the transfer that should be cancelled
  - `scicatToken` string — if the ingestor is configured to use ExtGlobusService for transfer, this endpoint needs a SciCat token
  - `deleteTask` boolean — if the entry needs to be deleted or not, in addition to cancelling it (by default false)

## Response `200`

Transfer canceled successfully

- DeleteTransferResponse
  - `transferId` string, required — Transfer id affected
  - `status` string — New status of the transfer.

## Other responses

- `400` — Invalid request

## Changes

> 50 revisions in range; 3 not diffed.

- **2025-04-16** `bb871dc3c241` — 1 info
  - added the new optional request property `deleteTask`
- **2025-04-16** `f61355a017f7` — 1 info
  - added the new optional request property `scicatToken`
- **2025-02-03** `bd936a25135c` — 1 breaking, 2 warning, 1 info
  - added the new required request property `transferId`
  - removed the request property `ingestId`
  - removed the optional property `ingestId` from the response with the `200` status
  - added the required property `transferId` to the response with the `200` status
- **2025-01-31** `318e4879b08f` — 1 breaking, 2 warning, 1 info
  - added the new required request property `transferId`
  - removed the request property `ingestId`
  - removed the optional property `ingestId` from the response with the `200` status
  - added the required property `transferId` to the response with the `200` status
- **2025-01-31** `89e14302a637` — 1 breaking, 1 warning, 2 info
  - removed the required property `transferId` from the response with the `200` status
  - removed the request property `transferId`
  - added the new optional request property `ingestId`
  - added the optional property `ingestId` to the response with the `200` status

[Full history](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/changes/transfer/delete.md)

---

[API](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api.md) · [All operations](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swissopenem/scicat-ingestor-api/revisions/f35bb454d121/schema)