CLI Menu

Command Line Interface (CLI) CLI QuickStart GuideCommand Line Interface (CLI) ExamplesUsing the CLI with High Assurance Resources


globus endpoint search - Search and discover endpoints


globus endpoint search ['OPTIONS'] 'FILTER_FULLTEXT'

globus endpoint search --filter-scope SCOPE ['OPTIONS'] ['FILTER_FULLTEXT']


The globus endpoint search command searches for endpoints with search filters. If --filter-scope is set to the default of all, then FILTER_FULLTEXT is required.

If FILTER_FULLTEXT is given endpoints which have attributes (display name, legacy name, description, organization, department, keywords) that match the 'SEARCH' text will be returned. The current result size limit is 100 endpoints.


--filter-scope 'SCOPE'

Search only endpoints in the specified 'SCOPE' (category). If this option is not specified, the scope is "all". Valid values for 'SCOPE' are:

all (default)

All endpoints for which the current user has visibility (e.g. this includes public endpoints owned by other users, and private and public endpoints owned by the current user). A 'SEARCH' argument is required for this scope.


Endpoints of any type created by the current user.


Globus Connect Personal endpoints created by the current user.


Endpoints that have active or pending tasks submitted by the current user


Endpoints that have been used for tasks submitted by the current user in the last 90 days.


Shared endpoints created by the current user


Shared endpoints the current user has access to (i.e. the ACL allows the current user)

--filter-owner-id 'UUID_OR_USERNAME'

Filter endpoints where the endpoint is owned by the given identity.

--map-http-status 'TEXT'

Map non success HTTP response codes to exit codes other than 1. e.g. "--map-http-satus 403=0,404=0" would exit with 0 even if a 403 or 404 http error code was received. Valid exit codes are 0,1,50-99.

-F, --format '[json|text]'

Set the output format for stdout. Defaults to "text".

--jq, --jmespath 'EXPR'

Supply a JMESPath expression to apply to json output. Takes precedence over any specified '--format' and forces the format to be json processed by this expression.

A full specification of the JMESPath language for querying JSON structures may be found at

-h, --help

Show help text for this command.

-v, --verbose

Control the level of output.

Use -v or --verbose to show warnings and any additional text output.

Use -vv to add informative logging.

Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)


Search for the Globus tutorial endpoints

$ globus endpoint search Tutorial --filter-owner-id

Search for endpoints owned by the current user

$ globus endpoint search --filter-scope my-endpoints


0 on success.

1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.

2 if the command was used improperly.

© 2010- The University of Chicago Legal