(Home >> Development >> Manage API Tokens)
The Manage API Tokens interface allows you to create, list, and revoke API tokens. API tokens allow you to log in to the server without the need for a password. You can use an API token to authenticate with WHM’s remote API.
This is useful, for example, to allow a reseller or third-party developer to run API function calls with your account's data.
- If you change a cPanel account's username in WHM's Modify an Account interface (Home >> Accounts >> Modify an Account), any API tokens associated with that account will continue to function.
- If you delete a cPanel account, the system automatically revokes the account's API token.
The API Tokens table
The API Tokens table contains the following information:
|Name||The API token's name.|
|Created||The time that you created the API token, in |
|Actions||Whether to revoke the API token.|
To search for an API token, enter a term in the Search text box. The interface automatically filters the API token names as you type.
To refresh the API tokens list, select the gear icon () next to the Actions column heading and click Refresh List.
Create an API token
To create an API token, perform the following steps:
- Click Generate Token. The Generate Token form will appear.
Enter a name for the API token in the Name text box.
An API token name's maximum length is 50 characters and the name can only contain alphanumeric characters, dashes (
-), and underscores (
Click Generate. The new API token, its name, and its creation time will appear in the API Tokens menu.
Make certain that you save your API token in a safe location on your workstation. You cannot access the token after you navigate away from the interface or refresh the API Tokens table.
Revoke an API token
To revoke an API token, perform the following steps:
- Locate the API token that you want to revoke in the API Tokens list.
- Under the Actions column, click Revoke. A confirmation message will appear.
- Click Continue to revoke the token. A message of success will appear in the upper-right corner of the interface.