> 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-documentation.md). 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](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="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FSCRJiducavf4WrOYUE9z%2Faccount.png?alt=media&amp;token=b52d3979-bd5d-413e-8b80-216230c2c554" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FI5h8RLCxqGF3q0okpsqw%2Fapiclients.png?alt=media&amp;token=680a7a9a-9277-4681-9d9d-d46367b6ecf9" 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="https://3702723385-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBgOfOR7RYuK5Fm69JAWF%2Fuploads%2FyuZc1vONH2tkJmLOynGm%2Fcreatedscreen.png?alt=media&amp;token=d26c0885-5897-4ec9-b547-82d1c7c19a81" 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 %}