Show/hide List Operations Expand Operations

CVE

/api/v2/cve/{cve_id}

DELETE /api/v2/cve/{cve_id}

Delete CVE item. Only allowed if affected host count for this CVE = 0

Documentation
Sandbox

Documentation

Delete CVE item. Only allowed if affected host count for this CVE = 0

Requirements

Name	Requirement	Type	Description
cve_id		string	CVE Id

Parameters

Parameter	Type	Required?	Format	Description
message	string	false		Commit message

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/cve/{cve_id}

Get CVE item info by Id

Documentation
Sandbox

Documentation

Get CVE item info by Id

Requirements

Name	Requirement	Type	Description
cve_id		string	CVE Id

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/v2/cve/{cve_id}

Disable or enable CVE

Documentation
Sandbox

Documentation

Patch CVE - set as disabled/enabled

Requirements

Name	Requirement	Type	Description
cve_id		string	CVE ID

Parameters

Parameter	Type	Required?	Format	Description
disabled	boolean	true		Disabled value: true ot false
message	string	false		Commit message

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cve_hosts_max_count

GET /api/v2/cve_hosts_max_count

Get hosts with max count of CVE - we include all CVE type

Documentation
Sandbox

Documentation

Get hosts with max count of CVE - we include all CVE type. If pub_key_digest is set . return only for that host

Requirements

Name	Requirement	Type	Description
limit		integer	Maximum number of records, default 5, max 10 000

Parameters

Parameter	Type	Required?	Format	Description
pub_key_digest	string	false		Host pub key

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cvelist

GET /api/v2/cvelist

Get list of CVE items detected in the system

Documentation
Sandbox

Documentation

Get list of CVE items detected in the system

Supported search fields:

cve_id - exact match
package_name - substring
disabled - boolean

Supported sort fields:

cve_id - (alphabetical)
package_name - (alphabetical)
score - numeric
updated - date
hosts_count - numeric
disabled - boolean

Requirements

Name	Type	Description
search	json	Search conditions. Supported fields: ^see description on top
sort_field	string	Field to sort, cve_id by default
sort_direction	string	Sort direction, asc by default
items_per_page	integer	Maximum number of records in result, default 30, max 1000
offset	integer	Offset

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cvescorestats

GET /api/v2/cvescorestats

Get CVE scores for active/disabled items based on severity

Documentation
Sandbox

Documentation

Get CVE scores for active/disabled items based on severity

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Change

/api/v2/affecteddevices

POST /api/v2/affecteddevices

Get list of affected devices by the change. Usual use case - when we change group rule - we need to know all devices which would receive this setting

Documentation
Sandbox

Documentation

Get list of affected devices by the change. Usual use case - when we change group rule - we need to know all devices which would receive this setting.

Requirements

Name	Type	Description
device_id	string	device id (usually this is group id
config	json	Config change as json
formtype	string	form which we change

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/change

DELETE /api/v2/change

Delete all uncommitted changes

Documentation
Sandbox

Documentation

Delete change

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/v2/change

Add new change to the configuration

Documentation
Sandbox

Documentation

Add new change to the configuration

Requirements

Name	Type	Description
device_id	string	Device or group id
config	json	Config change as json
formtype	string	form which we change

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/change/{change_id}

GET /api/v2/change/{change_id}

Get change - return change by id

Documentation
Sandbox

Documentation

Get change

Requirements

Name	Requirement	Type	Description
change_id		string	change id

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/changelist

GET /api/v2/changelist

Get list of changes

Documentation
Sandbox

Documentation

Get list of changes

Requirements

Name	Type	Description
search	json	Search conditions. Supported fields: user_id, group_id, status, form_type
created_start	date	Start date UTC, format: YYYY-MM-DD hh:ii:ss. Default -1 month from now
created_end	date	End date UTC, format: YYYY-MM-DD hh:ii:ss. Default: now
sort	string	Field to sort, created by default
sort_direction	string	Sort direction, desc by default
limit	integer	Maximum number of records, default 3000, max 10 000
offset	integer	Offset

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Commit

/api/v2/commit

POST /api/v2/commit

Commit changes and create a new configuration

Documentation
Sandbox

Documentation

Add new change to the configuration

Requirements

Name	Requirement	Type	Description
action		string	Action to execute. Only commit is supported for now)

Status Codes

Status Code	Description
200	Returned when successful
204	Returned when nothing to commit
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/commit/{commit_id}

GET /api/v2/commit/{commit_id}

Get commit - return commit by id

Documentation
Sandbox

Documentation

Get commit

Requirements

Name	Requirement	Type	Description
commit_id

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/commitlist

GET /api/v2/commitlist

Get list of commits

Documentation
Sandbox

Documentation

Get list of commits

Supported search fields:

commit_id - id of the commit (exact match)
message - commit message (substring), also search for CVE_ID (exact match)
user_id - id of the user who created commit (exact match)
committer - name or surname of the user (substring match)
change_id - id of the change (exact match)
changes - array of changes (exact match)
tags_include - array of tags which MUST be preset (exact match)
tags_exclude - array of tags which MUST NOT be preset (exact match)
start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss.

Supported sort fields:

user_id
created

Requirements

Name	Type	Description
search	json	Search conditions. Supported fields: ^see full list on top. Example: {"message": "update xyz"}
sort_field	string	Field to sort, created by default
sort_direction	string	Sort direction, desc by default
items_per_page	integer	Maximum number of records in result, default 30, max 1000
offset	integer	Offset
report_type	string	Detailed or short result. Default: short. Detailed includes config_history

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Company

/api/v2/company

POST /api/v2/company

Create company

Documentation
Sandbox

Documentation

Create company

Parameters

Parameter	Type	Required?	Description
pcompany_id	string	true	Parent company ID
name	string	true	Name of company
extref	string	false	External reference
billing_period	integer	false	Billing period. 1 - Monthly, 3 - Quarterly, 12 - Yearly

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/company/{company_id}

DELETE /api/v2/company/{company_id}

Delete company

Documentation
Sandbox

Documentation

Delete company

Requirements

Name	Requirement	Type	Description
company_id		string	Company ID

Status Codes

Status Code	Description
204	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/company/{company_id}

Get company

Documentation
Sandbox

Documentation

Get company information

Requirements

Name	Requirement	Type	Description
company_id		string	Company ID

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/v2/company/{company_id}

Update company

Documentation
Sandbox

Documentation

Update company

Requirements

Name	Requirement	Type	Description
company_id		string	Company ID

Parameters

Parameter	Type	Required?	Description
pcompany_id	string	false	Parent company ID
name	string	false	Name of company
extref	string	false	External reference
billing_period	integer	false	Billing period. 1 - Monthly, 3 - Quarterly, 12 - Yearly

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PUT /api/v2/company/{company_id}

Update company

Documentation
Sandbox

Documentation

Update company

Requirements

Name	Requirement	Type	Description
company_id		string	Company ID

Parameters

Parameter	Type	Required?	Description
name	string	true	Name of company
extref	string	false	External reference
billing_period	integer	false	Billing period. 1 - Monthly, 3 - Quarterly, 12 - Yearly

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/company/{company_id}/userlist

GET /api/v2/company/{company_id}/userlist

Get company users

Documentation
Sandbox

Documentation

Get list of company users

Requirements

Name	Requirement	Type	Description
company_id		string	Company ID

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/companylist

GET /api/v2/companylist

Get company list

Documentation
Sandbox

Documentation

Get list of companies

Parameters

Parameter	Type	Required?	Description
search	string	false	Search by name
limit	integer	false	Maximum number of records
offset	integer	false	Offset

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Config

/api/v2/config/{device_id}

GET /api/v2/config/{device_id}

Get config for device

Documentation
Sandbox

Documentation

Get config for the node

Requirements

Name	Requirement	Type	Description
device_id		string	Node id

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/configpreview/{device_id}

GET /api/v2/configpreview/{device_id}

Get config preview for device. It shows how config will look with all NEW (not commited) changes

Documentation
Sandbox

Documentation

Get config preview for the device

Requirements

Name	Requirement	Type	Description
device_id		string	Device or group id

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Device Attribute

/api/v2/deviceattribute/{device_id}

GET /api/v2/deviceattribute/{device_id}

Get user defined device information, such as device_name, address, location AND automatically discovered info by IP

Documentation
Sandbox

Documentation

Get device attribute information information

Requirements

Name	Requirement	Type	Description
device_id		string	device pub key

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/v2/deviceattribute/{device_id}

Get user defined device information, such as device_name, address, location AND automatically discovered info by IP

Documentation
Sandbox

Documentation

Update device custom info

Requirements

Name	Requirement	Type	Description
device_id		string	Device ID

Parameters

Parameter	Type	Required?	Description
device_name	string	false	Device name
description	string	false	Description
country	string	false	Country
city	string	false	City
zip	string	false	Zip code
address	string	false	Address
latitude	float	false	Latitude
longitude	float	false	Longitude

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Group

/api/v2/group

GET /api/v2/group

Get group - return full tree

Documentation
Sandbox

Documentation

Get group tree

Parameters

Parameter	Type	Required?	Format	Description
skip_unassigned	boolean	false		skip or not unassigned hosts in the tree output

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PUT /api/v2/group

Update group

Documentation
Sandbox

Documentation

Update group

Requirements

Name	Requirement	Type	Description
tree		json	Tree json structure

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/groupsummary/{device_id}

GET /api/v2/groupsummary/{device_id}

Get summary for the group

Documentation
Sandbox

Documentation

Get group

Requirements

Name	Requirement	Type	Description
device_id		string	Device id (or group)

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Inventory

/api/v2/inventory/{pub_key_digest}

DELETE /api/v2/inventory/{pub_key_digest}

Delete device - this will remove device from the inventory, group, configuration and associated reports.

Documentation
Sandbox

Documentation

Delete device

Requirements

Name	Requirement	Type	Description
pub_key_digest		string	Host pub key

Parameters

Parameter	Type	Required?	Format	Description
message	string	false		Commit message

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/inventory/{pub_key_digest}

Get inventory information about device

Documentation
Sandbox

Documentation

Get device inventory information

Requirements

Name	Requirement	Type	Description
pub_key_digest		string	device pub key

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/inventorylist

GET /api/v2/inventorylist

Get devices list

Documentation
Sandbox

Documentation

Get list of devices

Parameters

Parameter	Type	Required?	Description
report_type	string	false	short ir detailed report. allowed: short, detailed. Default: detailed
limit	integer	false	Maximum number of records
offset	integer	false	Offset

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/inventoryreport/{pub_key_digest}

GET /api/v2/inventoryreport/{pub_key_digest}

Get inventory report for the device

Documentation
Sandbox

Documentation

Get device inventory report

Requirements

Name	Requirement	Type	Description
device_id		string	device pub key
pub_key_digest

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/inventorysummarybytype

GET /api/v2/inventorysummarybytype

Get summary by inventory property type. 'ports' and 'users' are supported now

Documentation
Sandbox

Documentation

Get summary report by inventory property type. It will return combined info for each host by the property ( for example: ports or users. * NOTE: This method will be changed soon

Requirements

Name	Requirement	Type	Description
device_id		string	device pub key
type		string	Type name. Ports and users are supported by now

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Metric

/api/v2/metric/last

GET /api/v2/metric/last

Get last measurements for the cpu/mem/filesystem for all devices

Documentation
Sandbox

Documentation

Get last measurements for the cpu/mem/filesystem for all devices

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Pending hosts

/api/v2/pendinghost

GET /api/v2/pendinghost

Get pending hosts

Documentation
Sandbox

Documentation

Get pending hosts

Parameters

Parameter	Type	Required?	Description
pendingonly	boolean	false	If true - show only pending
limit	integer	false	Maximum number of records
offset	integer	false	Offset

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/v2/pendinghost

Approve host

Documentation
Sandbox

Documentation

Approve host

Parameters

Parameter	Type	Required?	Format	Description
pub_key_digest	string	true		device pub key

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/pendinghost/{pub_key_digest}

DELETE /api/v2/pendinghost/{pub_key_digest}

Reject host

Documentation
Sandbox

Documentation

Reject host

Requirements

Name	Requirement	Type	Description
pub_key_digest

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/removeapprovedhost/{pub_key_digest}

DELETE /api/v2/removeapprovedhost/{pub_key_digest}

Manual remove approved host from bootstrap. Warning: This is only for the advanced users

Documentation
Sandbox

Documentation

Manual remove approved host from bootstrap. Warning: This is only for the advanced users

Requirements

Name	Requirement	Type	Description
pub_key_digest

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Remote console

/api/v2/remoteconsoletoken/{ip_address}

GET /api/v2/remoteconsoletoken/{ip_address}

Get pending hosts

Documentation
Sandbox

Documentation

Get pending hosts

Requirements

Name	Requirement	Type	Description
ip_address

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

Report

/api/v2/reportlist

GET /api/v2/reportlist

Get reports

Documentation
Sandbox

Documentation

Get reports

Supported search fields:

report_id - id of the report (exact match)
commit_id - id of the commit (exact match)
pub_key_digest - array of the hosts id (exact match)
title - hostname (substring)
text - report text (substring)
labels_include - config change type, array, for example: ["software_management", "ntp"]
labels_exclude - config change type, array, for example: ["software_management", "ntp"]
status - "new" or "read"
severity - array, for example ["CRIT", "ERR"]
start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss

Supported sort fields:

title - host title (alphabetical)
pub_key_digest (alphabetical)
severity (alphabetical)
labels (alphabetical)
ts (integer)

Parameters

Parameter	Type	Required?	Description
search	json	false	Search conditions. Supported fields: ^see description on top
sort_field	string	false	Field to sort, ts by default
sort_direction	string	false	Sort direction, desc by default
items_per_page	integer	false	Maximum number of records in result, default 30, max 1000
offset	integer	false	Offset, default 0

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/reportmarkread

PATCH /api/v2/reportmarkread

Mark report(s) as read

Documentation
Sandbox

Documentation

Mark report(s) as read

Parameters

Parameter	Type	Required?	Format	Description
reports_array	json	true		Array of report id to mark as read. Example: ["588c7c64abf866624fb248eb"]

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/reportsummary

GET /api/v2/reportsummary

Get reports summary per hosts or for all hosts

Documentation
Sandbox

Documentation

Get reports summary for all host between dates. 1 year limit

Parameters

Parameter	Type	Required?	Description
pub_key_digest	string	false	device pub key
start	date	false	Start date UTC, format: YYYY-MM-DD hh:ii:ss. Default -24h from now
end	date	false	End date UTC, format: YYYY-MM-DD hh:ii:ss. Default: now

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

User

/api/v2/user

GET /api/v2/user

Get user

Documentation
Sandbox

Documentation

Get user information for the authenticated user

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/v2/user

Create user

Documentation
Sandbox

Documentation

Create user

Parameters

Parameter	Type	Required?	Description
company_id	string	true	User's company id
fname	string	true	First name
lname	string	true	Last name
email	string	true	Email
password	string	true	Password
enabled	boolean	false	Set if user is enabled (defult false)
roles	json	false	Array of user roles. Supported: ROLE_USER, ROLE_READ_ADMIN, ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_SUBSCRIPTION. Default: ROLE_USER. Example input: ["ROLE_USER", "ROLE_ADMIN"]

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/user/forgotpassword

POST /api/v2/user/forgotpassword

Send email with the reset password link

Documentation
Sandbox

Documentation

Send email with the reset token when forgot password form is submitted. It will return status 200 even if user is not exists in DB.

Parameters

Parameter	Type	Required?	Format	Description
email	string	true		User email

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if parameter is not set
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/user/register

POST /api/v2/user/register

Register new user

Documentation
Sandbox

Documentation

Register new user

Parameters

Parameter	Type	Required?	Description
fname	string	true	First name
lname	string	true	Last name
email	string	true	Email
password	string	true	Password
conf_password	string	true	Confirm password
company	string	true	Company name

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if parameter is not set or validation error
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/user/resetpassword

POST /api/v2/user/resetpassword

Reset user password

Documentation
Sandbox

Documentation

Reset password for the user if token and passwords are valid

Parameters

Parameter	Type	Required?	Description
token	string	true	Token from the reset email
password	string	true	New password
conf_password	string	true	Confirmation password

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if parameters is not set, invalid or expired token
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/user/{user_id}

DELETE /api/v2/user/{user_id}

Delete user

Documentation
Sandbox

Documentation

Delete user

Requirements

Name	Requirement	Type	Description
user_id		string	User ID

Status Codes

Status Code	Description
204	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/user/{user_id}

Get user

Documentation
Sandbox

Documentation

Get user information

Requirements

Name	Requirement	Type	Description
user_id		string	User ID

Status Codes

Status Code	Description
200	Returned when successful
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/v2/user/{user_id}

Path user

Documentation
Sandbox

Documentation

Patch user

Requirements

Name	Requirement	Type	Description
user_id		string	User ID

Parameters

Parameter	Type	Required?	Description
company_id	string	false	User's company id
fname	string	false	First name
lname	string	false	Last name
email	string	false	Email
password	string	false	Password
enabled	boolean	false	Set if user is enabled (defult false)
roles	json	false	Array of user roles

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PUT /api/v2/user/{user_id}

Update user

Documentation
Sandbox

Documentation

Update user

Requirements

Name	Requirement	Type	Description
user_id		string	User ID

Parameters

Parameter	Type	Required?	Description
company_id	string	true	User's company id
fname	string	true	First name
lname	string	true	Last name
email	string	true	Email
password	string	false	Password
enabled	boolean	false	Set if user is enabled (defult false)
roles	json	false	Array of user roles

Status Codes

Status Code	Description
204	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
404	Returned when resource not found
500	Returned for internal server error

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/userlist

GET /api/v2/userlist

Get users list

Documentation
Sandbox

Documentation

Get list of users

Parameters

Parameter	Type	Required?	Description
search	string	false	Search by first name or last name or email
limit	integer	false	Maximum number of records
offset	integer	false	Offset

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if required parameters are not set correctly
401	Returned when the user is not authenticated
403	Returned if access denied
500	Returned for internal server error

Input

Parameters

= -

Headers

= -

Content

= Replaces header if set

API documentation

CVE

/api/v2/cve/{cve_id}

DELETE /api/v2/cve/{cve_id}

Documentation

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/cve/{cve_id}

Documentation

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/v2/cve/{cve_id}

Documentation

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cve_hosts_max_count

GET /api/v2/cve_hosts_max_count

Documentation

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cvelist

GET /api/v2/cvelist

Documentation

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/cvescorestats

GET /api/v2/cvescorestats

Documentation

Status Codes

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Change

/api/v2/affecteddevices

POST /api/v2/affecteddevices

Documentation

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]