This box searches only this space. The box at the upper right searches the entire CyVerse wiki.

For overview information, see the CyVerse website.

Getting Started with CyVerse

Maintenance: Tues, 28 Jan 2020


Discovery Environment         8:00am to 5:00pm MST
The Discovery Environment will be unavailable while patches and updates are applied.
        ** Currently running analyses will be terminated. Please plan accordingly.

Data Store                    8:00am to 5:00pm MST
The Data Store will be unavailable during the maintenance period.
Data Commons                  8:00am to 5:00pm MST
The Data Commons will be unavailable during the maintenance period.
Atmosphere and Cloud Services 8:00am to 5:00pm MST
Marana Cloud: Atmosphere instances in the Marana Cloud will be operational; however, you will not be able to use the Data Store within your instance, and you may not be able to access the Atmosphere web interface.
User Portal                   8:00am to 5:00pm MST
The User Portal,, will be unavailable while we perform maintenance and updates.
Agave/Science API             8:00am to 5:00pm MST
The Agave/Science API will be unavailable during this maintenance period.
DNA Subway                    8:00am to 5:00pm MST
DNA Subway will be unavailable during this maintenance period.
The following services will NOT be affected by the maintenance: CyVerse Wiki and JIRA 

Keep up to date with our maintenance schedules on the CyVerse public calendar
Check your local timezone here 
Please contact for any questions, or concerns.






Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can register and use new API clients as well as search for CyVerse users by using the REST API. For an introduction to the CyVerse API clients, see Science APIs.

Registering API clients

You can request clients for available APIs so that you can implement CyVerse APIs programmatically. Once approved to use the client (usually within two business days), you receive an email with an auto-generated key and secret code, which can be regenerated if necessary.

You also can search for CyVerse users with Full REST API.

Registering an API client for your account

  1. Go to CyVerse User Management, click CyVerse Login, and enter your CyVerse username and password.
    If you have not already done so, you must register for an account. To retrieve or change your password, username, or email address, see Resetting Your Password.
  2. Click the API Clients tab.

    • To view documentation about the API, click  (User Manual).
    • To email the API maintainer, click  (Email the maintainer).
  3. To register an API client:
    1. In the Available APIs section, click Register a Client for the API you want to register.
    2. In the New API Client form, complete all fields:

      • Enter the name of the API client as it will be displayed in your My Clients list.
      • Enter a description of the client.
      • Enter or paste the URL of the website that explains your API client.
      • Enter or paste the IP address for the API client. If more than one IP address exists for the client, separate each IP address with a comma.
      • Enter a description of how you will use the data generated by use of the API client.
    3. Client Save.
      Within approximately 2 business days, you will receive an email from CyVerse Support about the registration of the API client. It approved, the client, key, and secret code will be available in your My API Clients list.

Regenerating an API client key

If you think your API client has been compromised, you can regenerate your key and secret code.

  1. On the API Clients tab, click Regenerate Keys.
    The new key and secret codes are displayed in your My API Clients list.
titleHelpful Links

On This Page:

Table of Contents

Helpful Links:


All API client authors must have a current CyVerse account and all API clients must be registered on the user's API Clients tab in the user management portal.


Requests must be made over SSL (i.e., to an https://URL) as in the following example:


Request URLs are RESTful: a resource label is requested along with an identifier, i.e. a search term.