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. Migrating Transfer Action Providers

Migrating Transfer Action Providers

Overview

This document provides important information for flow authors migrating to the Transfer action providers hosted at transfer.actions.globus.org.

Effective 1/22/2025, the following action providers are no longer supported:

  • https://actions.globus.org/transfer/collection_info

  • https://actions.globus.org/transfer/delete

  • https://actions.globus.org/transfer/ls

  • https://actions.globus.org/transfer/mkdir

  • https://actions.globus.org/transfer/set_permission

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

Other actions.globus.org action providers are not affected by this change.

Scopes

Unlike the deprecated action providers, all actions hosted at transfer.actions.globus.org use the same Globus Auth scope as the Transfer API itself: urn:globus:auth:scope:transfer.api.globus.org:all.

Some users may need to re-consent to continue using a flow after it has been updated to use the new Transfer action providers.

Action URLs

All flows using the deprecated Transfer action providers will need to update the ActionUrl on states using those actions.

For most actions this will just be replacing actions.globus.org/transfer/ with transfer.actions.globus.org/. For example, a state with an ActionUrl of https://actions.globus.org/transfer/collection_info should be changed to https://transfer.actions.globus.org/collection_info

An exception to this is the "set_permission" action provider, which has been renamed to "manage_permission". States using the https://actions.globus.org/transfer/set_permission ActionUrl should be changed to https://transfer.actions.globus.org/manage_permission.

Input Schema Changes

Several action input schemas have changed to better align with the underlying Transfer API.

Breaking Changes

These fields require changes when migrating to the new Transfer action providers:

  • /transfer

    • The transfer_items field has been renamed to DATA.

    • The source_endpoint_id field has been renamed to source_endpoint.

    • The destination_endpoint_id field has been renamed to destination_endpoint.

  • /delete

    • The items field has been renamed to DATA.

      • Elements within DATA must be objects with a path field, rather than strings. See examples at Delete.

    • The endpoint_id field has been renamed to endpoint.

  • /ls

    • the path_only field has been removed. If your flow needed it to determine if a path was a directory or not, note that Transfer now supports auto-detection of item type and the recursive field is now optional for transfer items.

      In cases where auto-detection is not sufficient, you can use the new stat action provider to get more detailed information about an item. An example of this usage is provided in the Move example flow.

Non-breaking Changes

These fields don’t require changes when migrating to the new Transfer action providers but provide new functionality not present in the legacy action providers:

  • /transfer

    • The recursive field is now optional for individual transfer items.

    • The optional fields filter_rules, perf_cc, perf_p, perf_pp and perf_udt are now supported.

  • /delete

    • The optional deadline field is now supported.

  • All documents that accept an optional DATA_TYPE field in the underlying Transfer API will accept that field in their input schema as well.

Removed Output Fields

Similar to the changes to input schemas, the outputs of the new Transfer action providers have been changed to better align with the underlying API. If your flow relies on these fields being present, it will need to be updated to use other fields that provide equivalent information.

  • The is_managed field has been removed from the output of the /collection_info action provider. This functionality can be replaced by checking if subscription_id is a non-null value, as it will always be non-null for subscribed endpoints/collections.

Note

Globus Connect Personal can use some premium features (such as using guest collections) when owned by a member of a subscription group. You may want to treat collections with an entity_type of "GCP_mapped_collection" or especially "GCP_guest_collection" as potentially able to use premium features even if they do not have a subscription_id set.

  • The is_folder field has been removed from the output of /ls. To replace this functionality, you can check if the value of the type field is "dir".

  • 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