Managing API Clients

Creating an API client is required to use Hydrosat's Discovery STAC API. This article covers the workflow for managing API Clients in the Discovery Portal.

Viewing the API Clients Management Interface

The API Clients management interface is available only to users on your account with the Org Admin role. If there is already an Org Admin on your account, this person can generate API clients for you to use the API.

To view the Client ID interface, click your user avatar in the top right corner of Discovery Portal and select Account.

Users with the requisite permissions will see the API Clients section on the Account page.

If you don't know who your team's Org Admin is, and you need access to the Client ID management interface, contact [e-mail] for assistance.

Creating an API Client

Each account is limited to 4 total API clients, so consider this limit when creating new API clients.

1. Click New API Client on the right side of the API Clients section.

2. Provide a name for the API client that is easily recognizable to you and other Org Admins. Name is required.

3. (Optional) Provide a description.

4. Click Create API Client

5. Immediately upon creation, the client secret for the API client is displayed. This display is only temporary. Store the client secret in a safe and secure location in your environment as you will not be able to retrieve it from Discovery Portal in the future.

If you've lost the secret for your API client, Hydrosat is unable to retrieve it for you for security reasons. Instead, create a new API client, at which time a secret for the new API client will be provided to you. Delete any API clients you can no longer use.