mirror of
https://github.com/Unleash/unleash.git
synced 2024-10-28 19:06:12 +01:00
d5fbd0b743
## What This (admittedly massive) PR updates the "physical" documentation structure and fixes url inconsistencies and SEO problems reported by marketing. The main points are: - remove or move directories : advanced, user_guide, deploy, api - move the files contained within to the appropriate one of topics, how-to, tutorials, or reference - update internal doc links and product links to the content - create client-side redirects for all the urls that have changed. A number of the files have been renamed in small ways to better match their url and to make them easier to find. Additionally, the top-level api directory has been moved to /reference/api/legacy/unleash (see the discussion points section for more on this). ## Why When moving our doc structure to diataxis a while back, we left the "physical' files lying where they were, because it didn't matter much to the new structure. However, that did introduce some inconsistencies with where you place docs and how we organize them. There's also the discrepancies in whether urls us underscores or hyphens (which isn't necessarily the same as their file name), which has been annoying me for a while, but now has also been raised by marketing as an issue in terms of SEO. ## Discussion points The old, hand-written API docs have been moved from /api to /reference/api/legacy/unleash. There _is_ a /reference/api/unleash directory, but this is being populated by the OpenAPI plugin, and mixing those could only cause trouble. However, I'm unsure about putting /legacy/ in the title, because the API isn't legacy, the docs are. Maybe we could use another path? Like /old-docs/ or something? I'd appreciate some input on this.
38 lines
1.9 KiB
Plaintext
38 lines
1.9 KiB
Plaintext
---
|
|
title: How to create API Tokens
|
|
---
|
|
|
|
import newTokenImage from '/img/admin_create_token_form.png';
|
|
|
|
:::info Permissions
|
|
|
|
Creating API tokens requires you to have the `CREATE_API_TOKEN` permission. This means that, as of now, **only instance admins can create API tokens.**
|
|
|
|
All users can see tokens with `CLIENT` level access, but only instance admins can see tokens with `ADMIN` level access.
|
|
|
|
:::
|
|
|
|
Unleash SDKs use API tokens to authenticate to the Unleash API. Unleash supports different types of API tokens, each with different levels of access and privileges. Refer to the [API tokens and client keys](../reference/api-tokens-and-client-keys.mdx) article for complete overview of the different token types.
|
|
|
|
## Step 1: Navigate to the API token creation form {#step-1}
|
|
|
|
Navigate to the _API access_ page in the admin UI (available at the URL `/admin/api`). Use the navigation menu item "Configure" and select "API access".
|
|
|
|
![The admin UI navigation "Configure" submenu with the API access item highlighted.](/img/admin_configure_api.png)
|
|
|
|
On the API access page, use the "New API token" button to navigate to the token creation form.
|
|
|
|
![The API access page with the "New API token" button highlighted.](/img/admin_new_api_key_button.png)
|
|
|
|
## Step 2: Fill in the API token form {#step-2}
|
|
|
|
![API token creation form. ](/img/admin_create_token_form.png)
|
|
|
|
Fill in the form with the desired values for the token you want to create. Refer to the [API tokens and client keys](../reference/api-tokens-and-client-keys.mdx#token-data) article for a detailed explanation of what all the fields mean.
|
|
|
|
## Using API tokens
|
|
|
|
When you have created the API token, it will be listed on the API access page. If you have the required permissions to see the token, you can copy it for easy use in your applications.
|
|
|
|
![API access token table with a "copy token" button highlighted.](/img/admin_copy_token.png)
|