---
title: "request a transfer task"
method: POST
path: "/transfer"
tags: ["transfer"]
---

# request a transfer task

`POST /transfer`

It allows for requesting transfer tasks against a SciCat token. It uses the service account configured with the service's instance

## Query parameters

- `sourceFacility` string, required — facility to use as source
- `destFacility` string, required — facility to use as destination
- `scicatPid` string, required — the SciCat PID of the dataset being transferred

## Request body

- object
  - `fileList` FileToTransfer[]
    - `path` string, required — the path of the file, it has to be relative to the dataset source folder
    - `isSymlink` boolean, required — specifies whether this file is a symlink

## Response `200`

successfully started a transfer task

- object
  - `jobId` string, required — the SciCat job id of the transfer job

## Other responses

- `400` — a general error response
- `401` — a general error response
- `403` — a general error response
- `500` — a general error response
- `503` — a general error response

## Changes

- **2025-04-16** `5a224a3ab463` — 1 info
  - the response property `jobId` became required for the status `200`
- **2025-04-10** `3399e48b2dc4` — 1 breaking
  - request body became required
- **2025-04-09** `42c3f2ed7eaa` — 1 info
  - added the non-success response with the status `503`
- **2025-04-09** `47a7c83ae9b9` — 1 warning, 1 info
  - removed the optional property `taskId` from the response with the `200` status
  - added the optional property `jobId` to the response with the `200` status
- **2025-03-31** `c6649430068c` — 1 info
  - the request property `fileList` became optional

[Full history](https://skmtc.dev/swissopenem/apis/scicat-globus-proxy-api-2/changes/transfer/post.md)

---

[API](https://skmtc.dev/swissopenem/apis/scicat-globus-proxy-api-2.md) · [All operations](https://skmtc.dev/swissopenem/apis/scicat-globus-proxy-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/swissopenem/apis/scicat-globus-proxy-api-2/revisions/733b2fe9c162?raw)