Update API tokens and client keys pages (#9143)

Author: melindafekete

frontend/src/component/integrations/IntegrationList/AvailableIntegrations/AvailableIntegrations.tsx

@@ -163,7 +163,7 @@ export const AvailableIntegrations: VFC<IAvailableIntegrationsProps> = ({
                         need a client SDK (software developer kit) for your
                         programming language and an{' '}
                         <a
-                            href='https://docs.getunleash.io/how-to/how-to-create-api-tokens'
+                            href='https://docs.getunleash.io/reference/api-tokens-and-client-keys'
                             target='_blank'
                             rel='noopener noreferrer'
                         >

src/lib/openapi/spec/create-pat-schema.ts

@@ -3,7 +3,7 @@ import type { FromSchema } from 'json-schema-to-ts';
 export const createPatSchema = {
     $id: '#/components/schemas/createPatSchema',
     description:
-        'Describes the properties required to create a [personal access token](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens), or PAT. PATs are automatically scoped to the authenticated user.',
+        'Describes the properties required to create a [personal access token](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens), or PAT. PATs are automatically scoped to the authenticated user.',
     type: 'object',
     required: ['description', 'expiresAt'],
     properties: {

src/lib/openapi/spec/pat-schema.ts

@@ -5,7 +5,7 @@ export const patSchema = {
     $id: '#/components/schemas/patSchema',
     type: 'object',
     description:
-        'Describes a [personal access token](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens), or PAT. PATs are automatically scoped to the authenticated user.',
+        'Describes a [personal access token](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens), or PAT. PATs are automatically scoped to the authenticated user.',
     required: ['id', 'createdAt', ...createPatSchema.required],
     properties: {
         id: {

src/lib/openapi/spec/pats-schema.ts

@@ -5,7 +5,7 @@ export const patsSchema = {
     $id: '#/components/schemas/patsSchema',
     type: 'object',
     description:
-        'Contains a collection of [personal access tokens](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens), or PATs. PATs are automatically scoped to the authenticated user.',
+        'Contains a collection of [personal access tokens](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens), or PATs. PATs are automatically scoped to the authenticated user.',
     properties: {
         pats: {
             type: 'array',

src/lib/routes/admin-api/project/api-token.ts

@@ -91,7 +91,7 @@ export class ProjectApiTokenController extends Controller {
                     operationId: 'getProjectApiTokens',
                     summary: 'Get api tokens for project.',
                     description:
-                        'Returns the [project API tokens](https://docs.getunleash.io/how-to/how-to-create-project-api-tokens) that have been created for this project.',
+                        'Returns the project-specific [API tokens](https://docs.getunleash.io/reference/api-tokens) that have been created for this project.',
                     responses: {
                         200: createResponseSchema('apiTokensSchema'),
                         ...getStandardResponses(401, 403, 404),

src/lib/routes/admin-api/user/pat.ts

@@ -62,7 +62,7 @@ export default class PatController extends Controller {
                     summary:
                         'Get all personal access tokens (PATs) for the current user.',
                     description:
-                        'Returns all of the [personal access tokens](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens) (PATs) belonging to the current user.',
+                        'Returns all of the [personal access tokens](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens) (PATs) belonging to the current user.',
                     responses: {
                         200: createResponseSchema(patsSchema.$id),
                         ...getStandardResponses(401, 403, 404),
@@ -82,7 +82,7 @@ export default class PatController extends Controller {
                     summary:
                         'Create a new personal access token (PAT) for the current user.',
                     description:
-                        'Creates a new [personal access token](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens) (PAT) belonging to the current user.',
+                        'Creates a new [personal access token](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens (PAT) belonging to the current user.',
                     requestBody: createRequestSchema(createPatSchema.$id),
                     responses: {
                         201: resourceCreatedResponseSchema(patSchema.$id),
@@ -105,7 +105,7 @@ export default class PatController extends Controller {
                     summary:
                         'Delete a personal access token (PAT) for the current user.',
                     description:
-                        'Deletes a [personal access token](https://docs.getunleash.io/how-to/how-to-create-personal-access-tokens) (PAT) belonging to the current user.',
+                        'Deletes a [personal access token](https://docs.getunleash.io/reference/api-tokens-and-client-keys#personal-access-tokens) (PAT) belonging to the current user.',
                     parameters: [
                         {
                             name: 'id',

website/docs/feature-flag-tutorials/serverless/implementing-feature-flags-in-aws-lambda.md

@@ -31,7 +31,7 @@ You should only initialize the Unleash SDK once during the lifespan of a serverl
 
 Why? AWS Lambda is designed to reuse the same instance for multiple invocations, enabling the expensive initialization process to occur only during the Lambda's "cold start." Subsequent "warm" invocations can then leverage the SDK, which has been pre-initialized, with all feature flag configurations cached in memory. This ensures efficient operation by minimizing initialization overhead and enhancing performance.
 
-You’ll also need to provide an [Unleash Server side API Token](/how-to/how-to-create-api-tokens) as an environment variable for the AWS Lambda. This authorizes the SDK to connect to the Unleash API.
+You’ll also need to provide an [Unleash Server side API Token](/reference/api-tokens-and-client-keys) as an environment variable for the AWS Lambda. This authorizes the SDK to connect to the Unleash API.
 
 ```javascript
 import {

website/docs/how-to/how-to-create-api-tokens.mdx

@@ -2,36 +2,9 @@
 title: How to create API Tokens
 ---
 
-import newTokenImage from '/img/admin_create_token_form.png';
+Depending on your [permissions](../reference/api-tokens-and-client-keys#api-token-permissions), you can create API tokens in the Unleash Admin UI in three ways:
+- **Admin > API access**: for client or frontend tokens; requires the Admin root role, or a custom root role with API token permissions.
+- **Settings > API access** inside a project: for project-specific client or frontend tokens; permitted for project Members or users with a [corresponding root role](../reference/api-tokens-and-client-keys#api-token-permissions).
+- **Profile > View profile settings > Personal API tokens**: for personal access tokens.
 
-:::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 documentation](../reference/api-tokens-and-client-keys.mdx) for a 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)

website/docs/how-to/how-to-create-personal-access-tokens.mdx

@@ -2,36 +2,34 @@
 title: How to use the Admin API
 ---
 
-This guide explains the steps required to getting access to and using the Admin API.
+This guide explains the steps required to using the Admin API.
 
-## Step 1: Create API token {#step-1-create-api-token}
+## Create API token
 
-You'll need either an [admin token](../reference/api-tokens-and-client-keys.mdx#admin-tokens) or a [personal access token](../reference/api-tokens-and-client-keys.mdx#personal-access-tokens) for this to work. To create one, follow the steps in the [_how to create API tokens_](../how-to/how-to-create-api-tokens.mdx) guide or the [_how to create personal access tokens_](./how-to-create-personal-access-tokens.mdx) guide, respectively.
+First, you'll need to create a [personal access token](/reference/api-tokens-and-client-keys.mdx#personal-access-tokens).
 
 Please note that it may take up to 60 seconds for the new key to propagate to all Unleash instances due to eager caching.
 
 :::note
 
-If you need an API token to use in a client SDK you should create a "client token" as these have fewer access rights.
+If you need an API token to use in a client SDK you should create a client token instead, as these have fewer access rights.
 
 :::
 
-## Step 2: Use Admin API {#step-2-use-admin-api}
+## Use Admin API
 
-Now that you have an access token with admin privileges we can use that to perform changes in our Unleash instance.
+Now that you have an access token with admin privileges, you can use it to make changes in your Unleash instance.
 
-In the example below we will use the [Unleash Admin API](/reference/api/legacy/unleash/admin/features.md) to enable the “Demo” feature flag using curl.
+In the example below we will use the [Unleash Admin API](/reference/api/legacy/unleash/admin/features.md) to enable the `checkout-flow` feature flag in `development` using curl.
 
 ```sh
 curl -X POST -H "Content-Type: application/json" \
-     -H "Authorization: some-token" \
-     https://app.unleash-hosted.com/demo/api/admin/features/Demo/toggle/on
+     -H "Authorization: <your-token>" \
+     https://app.unleash-hosted.com/docs-demo/api/admin/projects/docs-project/features/checkout-flow/environments/development/on
 ```
 
-**Great success!** We have now enabled the feature flag. We can also verify that it was actually changed by the API user by navigating to [Event Log](/reference/events#event-log) and filtering events for this feature flag.
+We have now enabled the feature flag. We can also verify that it was actually changed by the API user by navigating to [Event Log](/reference/events#event-log) and filtering events for this feature flag.
 
 ![Feature flag events showing that it was last updated by "admin-api".](/img/api_access_history.png)
 
-## API overview {#api-overview}
-
 You can find the full documentation on everything the Unleash API supports in the [Unleash API documentation](/reference/api/legacy/unleash/admin/features.md).