Discovery Configuration
This endpoint is used to fetch all the discovery configurations in the current organization (works based on token used to authorize)
Items Per Page
Page Number
Sorting Order
Sorting Key
GET /ux/ims/discovery/profile/?items_per_page=1&page=1 HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"ANY_ADDITIONAL_PROPERTY": "anything"
}
This endpoint is used to save a new discovery configuration for the current organization
POST /ux/ims/discovery/profile/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 387
{
"organization": "532475354328",
"agent_id": "xxxxxxxxxxxxxx",
"job_id": "2222222222",
"host": "192.168.50.1/24",
"label": "Auto_192.158.50.*",
"protocol": [
"snmp",
"ping"
],
"params": {
"filter_by_ping": 1,
"ping_monitor": 1,
"snmp_monitor": 1,
"exclude_ip_address": []
},
"credentials": [],
"creation_time": "now",
"created_by": "admin",
"schedule": {
"period": "Daily",
"hour": "00",
"min": "00",
"unit": "Days",
"days": "0"
}
}
{
"status": "success",
"job_id": 20,
"message": "discovery configuration created"
}
This endpoint is used to fetch a discovery configuration in the current organization
GET /ux/ims/discovery/profile/{id}/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to edit an existing discovery configuration for the current organization
Discovery Configuration serializers
PUT /ux/ims/discovery/profile/{id}/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 694
{
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to delete an existing discovery configuration for the current organization
No response body
No content
DELETE /ux/ims/discovery/profile/{id}/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
No response body
No content
This endpoint is used to get the audit for the given discovery job id
GET /ux/ims/discovery/profile/audit/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to get the detailed configuration of the discovery job id provided
GET /ux/ims/discovery/profile/details/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to get all the iterations for the given discovery job id
Discovery Configuration serializers
POST /ux/ims/discovery/profile/do-rescan/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 694
{
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
API endpoint that allows discovery configurations to be viewed or edited.
GET /ux/ims/discovery/profile/download_csv/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to fetch a custom scanning mechanism List with the options in the current organization
Discovery Configuration serializers
POST /ux/ims/discovery/profile/get-custom-scanner-fields/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 694
{
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to get all the iterations for the given discovery job id
GET /ux/ims/discovery/profile/iteration-list/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
API endpoint that allows discovery configurations to be viewed or edited.
Discovery Configuration serializers
POST /ux/ims/discovery/profile/multidelete/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 694
{
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
This endpoint is used to get the general options for dropdowns and UI elements
GET /ux/ims/discovery/profile/options/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
API endpoint that allows discovery configurations to be viewed or edited.
Discovery Configuration serializers
POST /ux/ims/discovery/profile/validate_csv/ HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 694
{
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}
{
"id": "text",
"sdwan_vendor": "text",
"edgeDevice_credentials": "text",
"last_update_time": "text",
"job_id": "text",
"label": "text",
"description": "text",
"organization": "text",
"agent_id": "text",
"host": "text",
"secondary_host": "text",
"params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"credentials": [],
"configuration_credentials": [],
"add_to_nccm": true,
"filter": [],
"schedule": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"protocol": [],
"configuration_protocol": [],
"is_csv_upload": 1,
"csv_data": [],
"created_by": 1,
"modified_by": 1,
"creation_time": "2025-08-31T23:49:35.746Z",
"is_deleted": true,
"job_iteration_id": "text",
"last_scan_result": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"configuration_download": true,
"download_params": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"customer_id": "text",
"customer_entity_id": "text"
}