Browse Endpoint
Overview
The Browse Endpoint helper page can be used to redirect your users to the Globus web app where they
will be able to select a target endpoint and optionally files and/or folders. The selected target will
be returned to you by way of an HTML form POST
(default) action.
Browse Endpoint is located at https://app.globus.org/file-manager?action=https://your.callback.url
Supported Query Parameters
-
method
-
action (required)
-
cancelurl
-
folderlimit
-
filelimit
-
label
-
ep
method
The method
parameter will be used for the <form>
element’s method
attribute.
Valid values: POST
, GET
.
Default: POST
.
cancelurl
Used as the destination to redirect the client to in the event the "Cancel" button is clicked.
folderlimit
Limits the number of folders that a user may select in the endpoint browser. If folderlimit
is 0
then selecting folders is not allowed.
Response
When the user submits the form, the following data will be sent to the URL
specified by the action
parameter as stringified JSON in the request body:
-
Fields from the Endpoint:
-
endpoint_id
– theid
from selected Endpoint Document. -
entity_type
– see Types of Endpoints for more details on possible values. -
high_assurance
-
-
Properties from the user-selected state:
-
path
-
label
-
folder[0]
,folder[1]
, …folder[n]
(if any; relative topath
) -
file[0]
,file[1]
, …file[n]
(if any; relative topath
)
-
Additionally, the parameters that the Browse Endpoint page was initialized
with (e.g. action
, cancelurl
, method
) will be echoed back in the data.