# Manage API Token

Visit the administration page about the API token to create and delete tokens. The used route is `/api-tokens`.

All available tokens are listed there. Use the button "**New API Token**" to create a token. 

![The tokens are only visible on mouseover.](/files/-M-yS1FrxaRnRD_fk992)

![Create a token either for yourself via Private or for an organisation](/files/-MDF5xUJ-EWoIpxZ25kF)

### Create tokens

The secret is created by **Data**Gym.ai. 

{% hint style="info" %}
The API-Support may be limited by the subscription plan.
{% endhint %}

The following attributes are required:

#### The token owner: <a href="#the-project-owner" id="the-project-owner"></a>

* Can be either created for youself by selecting Private, or you can select Organisation, where you can select all organisations of which you have admin permissions. If you don't have any organization you can create one by clicking on the + symbol.

#### The token name: <a href="#the-project-name" id="the-project-name"></a>

* The token name can be used to describe the token usage.
* This attribute cannot be used twice within one organisation.

{% hint style="info" %}
Name restrictions:&#x20;

* lower case only
* between 1 and 30 characters
* may include  `0 - 9, _, ., -`
  {% endhint %}

{% hint style="warning" %}
`API Tokens cannot be changed later.`
{% endhint %}

### View the secret

By default the api secrets used to connect third party software with DataGym are hidden behind some stars. To see the secret point with the mouse on the text. The plain value will be displayed and can be copied from there.

### Delete tokens

To delete a single api token, use the trash icon in the token list. This must be confirmed in a pop-up window.

{% hint style="danger" %}
`Deleted secrets cannot be restored later.`
{% 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.datagym.ai/documentation/api-token/manage-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.