Transfer API
  • Transfer API Documentation
  • API Overview
  • Task Submission
  • Task Events
  • Task Management
  • File Operations
  • Endpoints and Collections
  • Globus Connect Personal Management
  • Endpoint and Collection Search
  • Roles
  • Collection Bookmarks
  • Guest Collection Permission Management
  • Advanced Collection Management
  • Task Behavior
  • Transfer Action Providers
    • Migrating Transfer Action Providers
    • Transfer Action Provider: Transfer
    • Transfer Action Provider: Delete
    • Transfer Action Provider: Manage Permission
    • Transfer Action Provider: List Directory Contents
    • Transfer Action Provider: Stat File or Directory
    • Transfer Action Provider: Make Directory
    • Transfer Action Provider: Collection Info
    • Transfer Action Provider: Create GCP Guest Collection
    • Transfer Action Provider: Create GCSv5 Guest Collection
Skip to main content
Globus Docs
  • Getting Started
    Getting Started

    Getting Started and Tutorial docs cover how to perform some activity or provide an introduction to a feature. They are not comprehensive, but help you get started with Globus or with new Globus features.

    • Users
    • Admins
    • Developers
  • Reference
    Reference
    • Service
      • Auth
      • Groups
      • Transfer
      • Timers
      • Flows
      • Compute
      • Search
    • Agents
      • Globus Connect Server
      • GCS CLI
      • Globus Connect Personal
      • Globus Compute
    • SDK
      • Python
      • JS
    • Clients
      • CLI
    • Security and Compliance
      • Product Security
      • Privacy
      • Solutions for Sensitive Data
      • FAQs
  • Solutions & Guides
    Solutions & Guides

    Find practical approaches for leveraging Globus in research environments, integrating with platforms, and building science gateways. Access hands-on guides, integration instructions, and real-world scenarios for advanced usage.

    • Portals/Science Gateways
    • Guides
  • Support
    Support

    Find answers to frequently asked questions, connect with the community by joining our mailing lists, or reach out directly to Globus support.

    • FAQs
    • Mailing Lists
    • Contact Us
    • Check Support Tickets
  • Site Search
  1. Home
  2. Globus Services
  3. Transfer API Documentation
  4. Transfer Action Providers
  5. Transfer Action Provider: Transfer

Transfer Action Provider: Transfer

URL: https://transfer.actions.globus.org/transfer

Synchronous / Asynchronous: Asynchronous

The Transfer action provider uses the Globus Transfer API’s task resources to submit an asynchronous transfer of data from one Globus Collection to another. The input includes both the source and destination collection ids and file paths within the collection where the source file or folder is located and the destination folder where the transfer should be placed.

{
  "DATA": [
    {
      "source_path": "/~/campus_source/dataset1/",
      "destination_path": "/~/dmz_temp/"
    }
  ],
  "source_endpoint": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
  "destination_endpoint": "31ce9ba0-176d-45a5-add3-f37d233ba47d"
}
{
  "action_id": "1STabcdefghi",
  "completion_time": "2023-06-28T15:53:41.997573+00:00",
  "creator_id": "urn:globus:auth:identity:12341234-abcd-abcd-abcd-123412341234",
  "details": {
    "DATA_TYPE": "task",
    "bytes_checksummed": 0,
    "bytes_transferred": 0,
    "canceled_by_admin": null,
    "canceled_by_admin_message": null,
    "command": "API 0.10",
    "completion_time": null,
    "deadline": "2023-06-29T15:53:43+00:00",
    "delete_destination_extra": false,
    "destination_endpoint": "u_eyljfjd6jfg67nm6zp6gly4qpu#e09c6728-80a0-11ee-bddb-c52a29481bea",
    "destination_endpoint_display_name": "Globus Tutorial Collection 1",
    "destination_endpoint_id": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
    "directories": 0,
    "effective_bytes_per_second": 0,
    "encrypt_data": false,
    "event_list": [],
    "fail_on_quota_errors": false,
    "fatal_error": null,
    "faults": 0,
    "files": 0,
    "files_skipped": 0,
    "files_transferred": 0,
    "filter_rules": null,
    "history_deleted": false,
    "is_ok": true,
    "is_paused": false,
    "label": "For Action id 1STabcdefghi",
    "nice_status": "OK",
    "nice_status_details": null,
    "nice_status_expires_in": -1,
    "nice_status_short_description": "OK",
    "owner_id": "12341234-abcd-abcd-abcd-123412341234",
    "preserve_timestamp": false,
    "recursive_symlinks": "ignore",
    "request_time": "2023-06-28T15:53:44+00:00",
    "skip_source_errors": false,
    "source_endpoint": "u_eyljfjd6jfg67nm6zp6gly4qpu#e09c6728-80a0-11ee-bddb-c52a29481bea",
    "source_endpoint_display_name": "Globus Tutorial Collection 1",
    "source_endpoint_id": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
    "status": "ACTIVE",
    "subtasks_canceled": 0,
    "subtasks_expired": 0,
    "subtasks_failed": 0,
    "subtasks_pending": 1,
    "subtasks_retrying": 0,
    "subtasks_skipped_errors": 0,
    "subtasks_succeeded": 0,
    "subtasks_total": 1,
    "symlinks": 0,
    "sync_level": null,
    "task_id": "12341234-abcd-abcd-abcd-123412341234",
    "type": "TRANSFER",
    "username": "u_abcd",
    "verify_checksum": false
  },
  "display_status": "ACTIVE",
  "label": null,
  "manage_by": [],
  "monitor_by": [],
  "release_after": "P30D",
  "start_time": "2023-06-28 15:53:41.997556+00:00",
  "status": "ACTIVE"
}
{
  "__COMMENT": "The transfer task id will be `$.transfer_result.details.task_id`",
  "delete": {
    "Type": "Action",
    "ActionUrl": "https://transfer.actions.globus.org/transfer",
    "Parameters": {
      "source_endpoint.$": "$.endpoint_id",
      "destination_endpoint.$": "$.endpoint_id",
      "DATA": [
        {
          "source_path.$": "$.source_path",
          "destination_path.$": "$.destination_path"
        }
      ]
    },
    "ResultPath": "$.transfer_result"
  }
}
  • Transfer API Documentation
  • API Overview
  • Task Submission
  • Task Events
  • Task Management
  • File Operations
  • Endpoints and Collections
  • Globus Connect Personal Management
  • Endpoint and Collection Search
  • Roles
  • Collection Bookmarks
  • Guest Collection Permission Management
  • Advanced Collection Management
  • Task Behavior
  • Transfer Action Providers
    • Migrating Transfer Action Providers
    • Transfer Action Provider: Transfer
    • Transfer Action Provider: Delete
    • Transfer Action Provider: Manage Permission
    • Transfer Action Provider: List Directory Contents
    • Transfer Action Provider: Stat File or Directory
    • Transfer Action Provider: Make Directory
    • Transfer Action Provider: Collection Info
    • Transfer Action Provider: Create GCP Guest Collection
    • Transfer Action Provider: Create GCSv5 Guest Collection
© 2010- The University of Chicago Legal Privacy Accessibility