---
title: "Transfer files from an external Globus collection to a data release component."
method: POST
path: "/datacatalog/api/component/{id}/files/globus-transfer-in"
tags: ["Data Release"]
---

# Transfer files from an external Globus collection to a data release component.

`POST /datacatalog/api/component/{id}/files/globus-transfer-in`

## Request

- Base URL: `https://data.usgs.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://data.usgs.gov/datacatalog/api/component/{id}/files/globus-transfer-in`
- Auth: OAuth 2
  - Authorization code: `https://auth.globus.org/v2/oauth2/authorize?scope=openid`
  - Token URL: `https://data.usgs.gov/datacatalog/api/auth/login`

Transfer files from an external Globus collection to a data release component.

This endpoint takes a JSON payload consisting of a dictionary with a
`source_collection_id` string and a`files_to_transfer` list containing the
list of file paths in the source collection to transfer.

For Globus Connect Personal collections, the file path must include the
full local operating system path to the file,
e.g. "/Users/jdoe/Documents/globus-connect-personal/example.xml".

Paths referring to a directory will be ignored by the transfer task.

A file path cannot contain any of the following characters: < > : " / \ | ? *.
On Microsoft Windows, file paths must be formatted like /C/Users/username/filename.csv.

.. code-block::

    {
        "source_collection_id": "<Globus collection ID>,
        "files_to_transfer": [
            "/Users/jdoe/Documents/globus-connect-personal/example.xml"
        ]
    }

The response `data` includes a `task_id` for the submitted transfer. Poll
the transfer's status with `GET /data-release/files/task/{task_id}`.

:param id: The ID of the data release component.
:param data: The JSON payload containing the `source_collection_id` and the `files_to_transfer`.

## Path parameters

- `id` string, required

## Request body

- HorizonTransferParams
  - `source_collection_id` string, required
  - `files_to_transfer` string[], required: The list of file paths in the source collection to transfer. For Globus Connect Personal collections, the file path must include the full local operating system path to the file, e.g. "/Users/jdoe/Documents/globus-connect-personal/example.xml".

## Response `200`

Successful Response

- unknown

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation.md) - [All operations](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/revisions/f5f6a07ba13f?raw)