> ## Documentation Index
> Fetch the complete documentation index at: https://qovery-feat-qov-2094-ecr-pull-through-cache-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API Token

> Manage API tokens for programmatic access to your organization

An API Token is used by third-party applications or scripts to access to your organization via the Qovery API (CI/CD, Terraform, Pulumi, etc.).

You can manage API tokens attached to your organization directly from the Qovery Console or using the [Qovery CLI](/cli/commands/token).

<Note>
  Qovery offers a second kind of token. An **API Token** carries a
  [role](/configuration/organization/members-rbac) and is the right choice for
  CI/CD, Terraform and scripts. An
  [**API Policy Token**](/configuration/organization/api-policy-token) carries no
  role but a policy evaluated on every request, and is meant for autonomous
  agents that need a narrower footprint than any role can express.
</Note>

## Accessing API Tokens

<Steps>
  <Step title="Open Organization Settings">
    Click the Settings tab while you are on your organization overview.

    <Frame>
      <img src="https://mintcdn.com/qovery-feat-qov-2094-ecr-pull-through-cache-doc/2jqrGaihx-OaXBlN/images/configuration/organization/access_settings.png?fit=max&auto=format&n=2jqrGaihx-OaXBlN&q=85&s=8f2fede05c6676ce947486186eeb0dd9" alt="How to access your organization settings" width="2784" height="1830" data-path="images/configuration/organization/access_settings.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Token API Section">
    Open the **Token API** section within the organization settings

    <Frame>
      <img src="https://mintcdn.com/qovery-feat-qov-2094-ecr-pull-through-cache-doc/2jqrGaihx-OaXBlN/images/configuration/organization/token_api_access.png?fit=max&auto=format&n=2jqrGaihx-OaXBlN&q=85&s=d67172de31dd4b52836a4e6d5507f884" alt="How to access your Token API section" width="3164" height="2070" data-path="images/configuration/organization/token_api_access.png" />
    </Frame>
  </Step>
</Steps>

## Create a New Token

<Steps>
  <Step title="Click Add new Button">
    Press the **Add new** button to create a new API token
  </Step>

  <Step title="Configure Token">
    Provide the following information: - **Name**: A descriptive name for the
    token - **Description**: Purpose or usage details - **Role**: Select a role
    managed via the [Qovery RBAC system](/configuration/organization/members-rbac)
  </Step>

  <Step title="Save Token">
    After creation, the token will be displayed once
  </Step>
</Steps>

<Warning>
  **Important**: Make sure you safely store the token returned by the UI. You
  won't be able to retrieve it again (you will have to create a new one).
</Warning>

## Delete a Token

To remove an API token:

1. Locate the token in the Token API list
2. Click the **delete icon** (trash icon) next to the token
3. Confirm the deletion

## Edit a Token

<Note>
  This functionality is not yet available. To modify a token, you'll need to
  delete the existing one and create a new token.
</Note>