> For the complete documentation index, see [llms.txt](https://satdocs.hydrosat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://satdocs.hydrosat.com/discovery-portal/managing-api-clients.md).

# Managing API Clients

Creating an API client is required to use Hydrosat's [Discovery STAC API](/stac-api-reference-and-specification.md). This article covers the workflow for managing API Clients in the Discovery Portal.&#x20;

## Viewing the API Clients Management Interface

The API Clients management interface is available only to users on your account with the `Org Admin` role.

To view the Client ID interface, click your user avatar in the top right corner of [Discovery Portal](https://discover.hydrosat.com/) and select `Account`.

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

<figure><img src="/files/RPNl7jdtieC7l2KMBdX6" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/67ejiRz1tzIPoRLTguaV" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you don't know who your team's Org Admin is, and you need access to the Client ID management interface, contact <support@hydrosat.com> for assistance.
{% endhint %}

## 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.

<figure><img src="/files/rZieovHlivIMT5xTcT05" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
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.
{% endhint %}
