Transfer API Menu
  • Transfer API Documentation
  • API Overview
  • Endpoint Activation
  • Task Submission
  • Task Monitoring
  • File Operations
  • Endpoint Management
  • Endpoint Search
  • Endpoint Roles
  • Endpoint Bookmarks
  • Endpoint ACL Management
  • Advanced Endpoint Management
  • Change History
Skip to main content
Globus Docs
  • APIs
    Auth Compute Flows Globus Connect Server Groups Search Transfer Python SDK Helper Pages
  • How To
  • Guides
    Globus Connect Server High Assurance Collections for Protected Data Command Line Interface Premium Storage Connectors Security Modern Research Data Portal
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus APIs
  3. Transfer API Documentation
  4. Transfer Action Providers

Transfer Action Provider: Create GCSv4 Share

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

Synchronous / Asynchronous: Synchronous

The Create GCSv4 Share action provider uses the Globus Transfer Create Shared Endpoint API to create a shared endpoint on a Globus Connect Server v4 host.

{
  "host_endpoint": "ddb59aef-6d04-11e5-ba46-22000b92c6ec",
  "host_path": "/~/shared/",
  "display_name": "My Shared Endpoint"
}
{
  "action_id": "PbsSg2KHHyFG",
  "completion_time": "2023-06-27 21:09:12.058825+00:00",
  "creator_id": "urn:globus:auth:identity:12341234-abcd-abcd-abcd-123412341234",
  "details": {
    "DATA_TYPE": "endpoint_create_result",
    "canonical_name": "u_abcd#12341234-abcd-abcd-abcd-123412341234",
    "code": "Created",
    "globus_connect_setup_key": null,
    "id": "12341234-abcd-abcd-abcd-123412341234",
    "message": "Shared endpoint created successfully",
    "request_id": "yBzeD558j",
    "resource": "/shared_endpoint"
  },
  "display_status": "SUCCEEDED",
  "label": null,
  "manage_by": [],
  "monitor_by": [],
  "release_after": null,
  "start_time": "2023-06-27 21:09:10.688980+00:00",
  "status": "SUCCEEDED"
}
{
  "__COMMENT": "The resulting share id will be `$.create_share_result.details.id`",
  "create_share": {
    "Type": "Action",
    "ActionUrl": "https://transfer.actions.globus.org/gcsv4/create_share",
    "Parameters": {
      "display_name.$": "$.display_name",
      "host_path.$": "$.path",
      "host_endpoint.$": "$.endpoint_id"
    },
    "ResultPath": "$.create_share_result"
  }
}
  • Transfer API Documentation
  • API Overview
  • Endpoint Activation
  • Task Submission
  • Task Monitoring
  • File Operations
  • Endpoint Management
  • Endpoint Search
  • Endpoint Roles
  • Endpoint Bookmarks
  • Endpoint ACL Management
  • Advanced Endpoint Management
  • Change History
© 2010- The University of Chicago Legal Privacy Accessibility