API Shell

API Shell

This interface allows you to run cPanel API functions interactively.

Warning:

This feature uses live data from your server. API function calls may change or delete data on your server, which can cause your server to fail.

  • Read the documentation for a function call thoroughly before you use it in the API Shellinterface, a script, or through any other method.
  • To see an example of the output from a specific function call that uses test data, read the Example section for that function call in our Software Development Kit documentation.

Enable the cPanel API Shell

To use this feature, your system administrators must enable it for you. Ask them to perform the following steps in WHM:

  1. Select On for the cPanel & WHM API Shell (for developers) setting in the System tab of WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings).

  2. Grant the API Shell feature to the desired users in WHM's Feature Manager interface (Home >> Packages >> Feature Manager).

  3. You must use a reseller account to access the API Shell interface.

Run a cPanel API function

To run a cPanel API function, perform the following steps:

  1. Select the API that you wish to use.

    Notes:

    • Only cPanel API version 2 and UAPI are available in this interface.
    • To learn more about each function, read our Guide to UAPI and Guide to cPanel API 2 documentation.

  2. Select the API function that you wish to test from the menu.

  3. Enter the keys and values that you wish to test.
    • To enter more keys and values, click Add.

  4. To filter, sort, or paginate the results, click Show Sort/Filter/Paginate Options.
    1. To select the first record to show from the results, enter the number in the Index of first result to show, zero-based text box or use the menu to select the number.

    2. To limit the number of results to display, enter the maximum number of results in the Maximum # of results to show text box or use the menu to select the number.

    3. To filter the results, click Add in the Filters section of the interface.
      • You can specify the field by which you wish to filter the results, the conditions, and the Term to apply to the conditions.
      • To use more than one filter, click Add for each additional filter that you wish to specify.

    4. To sort the results, click Add in the Sorts section of the interface.
      • You can specify the field by which you wish to sort the results, the conditions, and whether you wish to reverse the sort order.
      • To use more than one sort method, click Add for each additional sort method that you wish to specify.

    5. To limit the columns to display, click Add in the Columns section of the interface.
      • Enter the column number in the Column text box.
      • To specify more columns to display, click Add.

  5. Click Submit.

API call results

The results appear in the API call response section of the interface.

You can view the results in Table view, Tree view, or the Raw response.

Note:

The Raw response separates the API call's response from the HTTP headers.

  • 1 Users Found This Useful
Was this answer helpful?

Related Articles

WebHost Manager

WebHost Manager This is a shortcut link to the WebHost Manager® (WHM®) WebHost Manager®...

Cron Jobs

Cron Jobs Cron jobs are scheduled tasks that the system runs at predefined times or...

Track DNS

Track DNS This interface contains tools to help you retrieve network information. For...

Indexes

Indexes When a visitor accesses a directory (rather than a page) on your web site,...

Error Pages

Error Pages Error pages inform visitors about problems when they attempt to access your...