# How can I get my Discloud API token?

## 🔑 What is the Discloud API Token?

Your **Discloud API Token** is a **personal, secret credential** that authenticates you to all Discloud developer surfaces:

* [**REST API requests**](/en/api-and-integrations/api-overview.md)
* [**Official CLI**](/en/how-to-host-using/cli.md)
* [**VS Code Extension**](/en/how-to-host-using/visual-studio-code.md)
* **SDK / Libraries** (e.g. [npm](/en/sdks-and-libraries/npm-library.md), [Python](/en/sdks-and-libraries/python-library.md))

It uniquely identifies your account, so **anyone with this token can act as you**. Treat it like a password.

***

## 📍 Where to Get It

Follow these steps to view (or copy) your token on the Dashboard:

{% stepper %}
{% step %}
Open the Dashboard: <https://discloud.com/dashboard>
{% endstep %}

{% step %}
Click the **API Key** tab (top section of your profile area).

<figure><img src="/files/QqDT0BYTYEbHHm3P5zLf" alt="Dashboard API Key tab"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Use the **Copy** button to place the token on your clipboard.
{% endstep %}
{% endstepper %}

> If the field is hidden, click the **eye icon** to reveal it. Use **Reset Token** only if you suspect compromise.

***

## 🔒 Security Best Practices

| Practice                                    | Why                               |
| ------------------------------------------- | --------------------------------- |
| Keep it private (never share or screenshot) | Prevent account takeover          |
| Do NOT commit to Git                        | Public repos are scanned by bots  |
| Use environment variables / secret managers | Centralized rotation & safer logs |
| Rotate (Reset Token) if exposed             | Immediately invalidates old token |

{% hint style="warning" %}
If you accidentally publish or paste your token somewhere public, **reset it immediately** on the Dashboard (API Key tab) and redeploy any services using the old one.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.discloud.com/en/faq/general-questions/how-can-i-get-my-discloud-api-token.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.