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

# API Tokens

> Create and manage API access tokens for your organization

## Overview

API tokens allow you to authenticate programmatically with the Royaltyport API. Each token is scoped to either your entire organization or a specific project, and can have a configurable expiration date. Only organization **Admins** and **Owners** can create and delete tokens.

<Note>
  The Royaltyport API is currently in closed Beta. Contact [hello@royaltyport.com](mailto:hello@royaltyport.com) to get early access.
</Note>

***

## Accessing API Tokens

<Steps>
  <Step title="Go to Organization Settings">
    Navigate to your organization from the Dashboard, then click **Settings** in the navigation.
  </Step>

  <Step title="Select Tokens">
    Click the **Tokens** tab in the settings sidebar.
  </Step>
</Steps>

***

## Creating a Token

<Steps>
  <Step title="Enter a token name">
    Give the token a unique, descriptive name so you can identify it later (e.g., "Production Integration" or "Data Export Script").
  </Step>

  <Step title="Select a scope">
    Choose what this token should have access to:

    | Scope                | Access                                                 |
    | -------------------- | ------------------------------------------------------ |
    | **Organization**     | Grants access to all projects within your organization |
    | **Specific project** | Restricts access to a single named project only        |

    Use a project-scoped token when you want to limit a token's access to one project (e.g., for a third-party integration). Use an organization-scoped token when your workflow spans multiple projects.
  </Step>

  <Step title="Set an expiration">
    Choose how long the token should remain valid:

    | Option  | Duration              |
    | ------- | --------------------- |
    | 1 Day   | Expires after 1 day   |
    | 7 Days  | Expires after 7 days  |
    | 30 Days | Expires after 30 days |
    | 60 Days | Expires after 60 days |
    | 90 Days | Expires after 90 days |
    | Never   | Token does not expire |

    A preview of the exact expiration date is shown below the selector.
  </Step>

  <Step title="Click Create">
    Click the **Create** button. A dialog will appear showing your new token value.
  </Step>

  <Step title="Copy and save your token">
    Copy the token and store it in a secure location such as a password manager or secrets vault.

    <Warning>
      This is the only time your token value will be displayed. Once you close the dialog, it cannot be retrieved again.
    </Warning>
  </Step>
</Steps>

***

## Managing Existing Tokens

The tokens table shows all active tokens for your organization, including:

| Column          | Description                                                                        |
| --------------- | ---------------------------------------------------------------------------------- |
| **Name**        | The token's display name                                                           |
| **Created**     | When the token was created and when it expires                                     |
| **Scope**       | Either **Organization** (access to all projects) or the name of a specific project |
| **Last active** | When the token was last used to make an API request                                |

### Deleting a Token

To delete a single token, click the **...** menu on any row and select **Delete**. Confirm in the dialog that appears.

<Warning>
  Deleting a token is immediate and cannot be undone. Any application or script using that token will lose access right away.
</Warning>

### Bulk deletion

To delete multiple tokens at once, select the checkboxes next to the tokens you want to remove, then open the **...** menu in the table header and choose **Delete selected**.

***

## Permission Requirements

| Action         | Required Role |
| -------------- | ------------- |
| View tokens    | Admin, Owner  |
| Create a token | Admin, Owner  |
| Delete a token | Admin, Owner  |

<Note>
  Members with the **Member** role cannot access organization settings and cannot manage API tokens.
</Note>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="API Introduction" icon="code" href="/api-reference/introduction">
    Learn how to authenticate and use the Royaltyport API.
  </Card>

  <Card title="Members & Roles" icon="users" href="/organizations/settings/members/roles">
    Understand organization role permissions.
  </Card>

  <Card title="General Settings" icon="settings" href="/organizations/settings/general">
    Configure your organization's basic information.
  </Card>

  <Card title="Security" icon="shield" href="/organizations/settings/security/sso">
    Configure SSO and audit logs.
  </Card>
</CardGroup>