Child pages
  • Manage API Tokens in cPanel
For cPanel & WHM version 80.


Skip to end of metadata
Go to start of metadata

(cPanel >> Home >> Security >> Manage API Tokens)

Overview

Important:

  • This functionality is experimental. It may change in future versions.
  • The Unrestricted application programming interface (API) tokens can access API functions that do not have an associated feature.

This feature lets you create, list, update, and revoke API tokens. The server recognizes API tokens and allows you to run API functions. API functions allow you to view and change account data without the need to log in to the cPanel interface. You can issue API tokens to allow others to run API functions with your account's data. For example, you could issue an API token to a reseller. The reseller could use that token to check disk usage.

Note:

Create an API token

To create an API token, perform the following steps:

  1. Click Create. The Create API Token interface will appear.
  2. Enter a name in the API Token Name text box.

    Note:

    • An API token name can only contain up to 50 characters.
    • You can only enter letters (az) and (AZ), numbers (0 9), dashes ( - ), and underscores ( _ ).
    • You must enter a name that does not already exist on the account.
  3. Click Create. A new interface will appear.

    • To copy the API token, click Copy. Think of this token like a password. You must enter this token each time that you use it.

      Warning:

      You cannot access the token after you navigate away from the interface. If you forget or misplace this token, you must revoke the token and then create a new one.

  4. Click Yes, I Saved My Token.

    Note:

    • To create a new token, select the Create another token after I click Yes, I saved my token checkbox.

    • To return to the List API Tokens interface, deselect the Create another token after I click Yes, I saved my token checkbox.

In This Document

Related Documentation

For Hosting Providers

The API Tokens table

The API Tokens table contains the following information:

ColumnDescription
Token NameThe API token's name.
CreatedThe date and time that you created the API token.
Manage

Click Manage to open a new interface where you can perform the following actions:

  • Rename Token — Assign a new name for the token.
  • Revoke the Token — Delete the token, and prevent it from accessing the server or any API functions.

To display more API tokens per page, click the gear icon () and then select a number.

To revoke multiple tokens:

  1. Select the checkboxes for each token to revoke. Select the checkbox at the top of the table to select every token.
  2. Click Revoke. A confirmation message will appear.
  3. Click Revoke Selected API Tokens.

Manage an API token

To manage an API token, locate the token in the API Tokens table and then click Manage. The Manage API Token interface will appear.

Rename Token

To assign a new name for the token, enter a new name in the New API Token Name text box. Then click Update.

Revoke the Token

Warning:

If you revoke an API token, users will no longer be able to run any scripts or API functions that use that API token.

To revoke an API token:

  1. Click Revoke. A confirmation message will appear.
  2. Click Yes, Revoke the Token to revoke the token.