API Configuration

Updated on 04 Aug 2025
3 Minutes to read

Article summary

Did you find this summary helpful?

Thank you for your feedback

Overview

To discover multiple type of devices, SummitAI now offers API based discovery. Based on the API configuration, the Servers, Networks, Links, Printers, and Laptop devices in the organization can be identified or define to establish connection with the configured APIs. It identifies or supports all the devices wherever an APIs is required.

Using API configuration, you can:

Establish connection with the API.
Manage Repository of templates.
Append API based discovery.
Sending Notification.
Maintaining Logs and reports.

User Persona – Administrator

Business Benefits

Identifying devices that are un-operational.
Better data related to troubleshooting, by checking the logs of devices that are inactive.
Sending email notifications for devices that are inactive.

Creating API Configuration

An API Configuration enables to you to create API configuration using which you can discover multiple devices.

To create an API Configuration:

Navigate to Admin > Discovery & Monitoring > API Configuration.
An API Configuration screen appears.
Figure: API Configuration
Select the configured Tenant name from the list.
Enter the required details. For more information about the fields on the API Configuration page see, Field Description.
Click Submit.

Field Description

Field	Description
Tenant	Select the Tenant’s name configured in the Tenant page. For more information, see Configuration Tenant.
API Configuration List	The list of previously configured API appears in the list. You can search the specific API by entering the name in the Search API Configurations field. On selecting the API name the details of the API appears on the API CONFIG DETAILS section. Note: Select the Include Inactive check box to include the inactive API in the API Configuration List.
API CONFIG DETAILS
API Config Name	Enter the API config name while creating a new API or the previously configured API config name appears on selection from API Configuration List. This is a mandatory field.
Environment	Select the environment name from the list. This is a mandatory field.
Module	Select the module name from the list. This is a mandatory field.
Active	Select the check box to make the API Config Details active. This check box is enabled, by default.
API Details
API Name	Enter the API name for the API configuration. You can configure multiple APIs for an API configuration.
Method	Select the standard API method from the list. The options are: GET – To fetch the information. POST – To create a new entry. PUT - To update the information.
API Timeout (In seconds)	Type in the API Timeout value (in millisecond). Based on the entered timeframe the API is timed out.
Params
Key	Specify the key.
Value Key	Select the value of the key. The field contains the following values: Static API
API	Select previously configured API name from the list.
API Element	Select an API element name configured for the selected API appears in the list.
Value	Specify the value. This field is enabled if the Value Type is selected as ‘Static’.
Description	Type in a brief description about the parameter.
Action	Click to add the specified parameters.
Authentication
Authentication Type	Select the pre-defined authentication values of the list. The listed values are: No Authentication. API Key - Specify the API key details. Bearer Token - Specify the token. Basic - Specify the credentials for the authentication. OAuth 2.0 - Enter the required auth details.
Headers
Key	Specify the key.
Value Key	Select the value of the key. The field contains the following values: Static API
API	Select previously configured API name from the list.
API Element	Select an API element name configured for the selected API appears in the list.
Value	Specify the value. This field is enabled if the Value Type is selected as ‘Static’.
Description	Type in a brief description about the parameter.
Action	Click to add the specified parameters.
Body
Request Type	Select the Request Type from the list. Based on Request Type, the actions occur.
Response
Status	The standard HTTP status codes are displayed to indicate whether the API request is executed successfully or not. Following are the standards response codes: Successful Responses (200-299) Client Errors (400-499) Server Errors (500-599)
Description	The description of the API response appears.

Modifying API Configuration

You are enables to edit the API Configuration based on the requirements.

To modify API configuration, perform the following steps:

Navigate to Admin > Discovery & Monitoring > API Configuration.
The API Configuration screen appears.
Select the configured Tenant name from the list.
Click the configured API from API Configuration List.
The detail of configured API appears in the API detail sections.
Click to edit the previously configured API.
The configured details appear.
Figure: API Configuration
Edit the required fields and click SUBMIT to update the modified details.

Click	To
	Edit the configured API.
	Delete the configured API.
	Add the configured parameters to the list.
	Save the configured API configuration.
	Cancel the configured API.

Was this article helpful?

What's Next

Discovery Templates

Table of contents