---
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
- `collectionRootPath` string, required
- `autoArchive` boolean — start archive job

## 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

- **2026-03-31** `efeb47829552` — 1 breaking
  - for the `query` request parameter `autoArchive`, default value `true` was added
- **2026-03-16** `3d955e233bf8` — 1 info
  - added the new optional `query` request parameter `autoArchive`

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

---

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