> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streamkap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Tokens

> How to generate and manage your Streamkap API tokens

## Create an API Token

Before you can use the Streamkap REST API, you'll need to generate an API token. API tokens are scoped to **Projects** and **Roles** in the Streamkap platform.

To generate an API token:

* Navigate to your project and go to **Project Settings**.

* Click on the **API** tab to access API Tokens.

* Click **Create API Token**:

  * Enter a description e.g. 'Read-only API access'
  * Choose the role(s) it applies to e.g. Read Only

* Click **Create Token**.

<Frame>
  <img src="https://mintcdn.com/streamkap/XHyf-lapReBk-adj/images/docs/api-tokens-create-dialog.png?fit=max&auto=format&n=XHyf-lapReBk-adj&q=85&s=aafb4ba3e2c93c691c30b29d79ae0078" alt="Create API Token dialog with description and role selection" width="896" height="884" data-path="images/docs/api-tokens-create-dialog.png" />
</Frame>

Once the API token is created, you will have one chance to copy and save its Token somewhere safe. Once you have done that, click **Done**.

<Frame>
  <img src="https://mintcdn.com/streamkap/XHyf-lapReBk-adj/images/docs/api-tokens-generated.png?fit=max&auto=format&n=XHyf-lapReBk-adj&q=85&s=6609d89705fce42b6961b7a60367b6ee" alt="Generated API Token showing Client ID and Token secret" width="463" height="428" data-path="images/docs/api-tokens-generated.png" />
</Frame>

Once you have a **Client ID** and **Token**, you can make a call to the **Get Access Token** REST API endpoint (under the **API Reference** tab) with those values to get your REST API access and refresh tokens.

## Manage API Tokens

<Info>
  Tokens can't be moved between Projects or have the Roles scope changed after they're created.
</Info>

To create, view and delete API Tokens:

* Navigate to your project and go to **Project Settings**.
* Click on the **API** tab to access API Tokens.

<Warning>
  The Token (or 'secret') is only shown **once**. If you have lost or forgotten an existing Tokens' secret, you will need to delete it and create another.
</Warning>

<Frame>
  <img src="https://mintcdn.com/streamkap/XHyf-lapReBk-adj/images/docs/api-tokens-list.png?fit=max&auto=format&n=XHyf-lapReBk-adj&q=85&s=4fdb52461159c3ffaf5af21a4292df07" alt="API Tokens list showing Client IDs, descriptions, roles, and creation info" width="2566" height="2016" data-path="images/docs/api-tokens-list.png" />
</Frame>
