Show/hide List Operations Expand Operations

Analysis

/api/v2/analysis

GET /api/v2/analysis

Get analysis reports

Documentation
Sandbox

Documentation

Get analysis report

Supported search fields:

pub_key_digest - array of the devices id (exact match) - all report types
- Users
user - regex
comment - regex
pwd_alg - array. Allowed values [-1, 1, 2, '2a', 5, 6, 'unknown']. Where -1 - not set; 1 - MD5; 2 - Blowfish; 2a - Eksblowfish; 5 - SHA-256; 6 - SHA-512.
- Ports
proto - regex
socket - regex
proc_info - regex
- Software
name - regex
version - regex
arch - regex
update - regex (expected same format as version)

Supported sort fields:

pub_key_digest (alphabetical)
title (alphabetical)
device_name (with fallback to fqhost if not present) Supported report types:
health
users
settings
logs
cve
software

Parameters

Parameter	Type	Required?	Description
search	json	false	Search conditions. Supported fields: ^see description on top
type	string	true	Report type: ^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

Show/hide List Operations Expand Operations

Bootstrap

/api/v2/bootstrapkey

POST /api/v2/bootstrapkey

Generate a new key and return to the client. NOTE: no parameters needed

Documentation
Sandbox

Documentation

Generate a new bootstrap 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

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/bootstrapkey/{bootstrap_key}

DELETE /api/v2/bootstrapkey/{bootstrap_key}

Delete bootstrap key

Documentation
Sandbox

Documentation

Delete bootstrap key

Requirements

Name	Requirement	Type	Description
bootstrap_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

GET /api/v2/bootstrapkey/{bootstrap_key}

Get bootstrap key

Documentation
Sandbox

Documentation

Get bootstrap key

Requirements

Name	Requirement	Type	Description
bootstrap_key		string

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

PUT /api/v2/bootstrapkey/{bootstrap_key}

Enable or disable auto accept and set default group for the key

Documentation
Sandbox

Documentation

Enable or disable auto accept and set group

Requirements

Name	Requirement	Type	Description
bootstrap_key		string	Bootstrap key ID

Parameters

Parameter	Type	Required?	Format	Description
auto_accept	boolean	true		Auto accept value: true ot false
group_id	string	true		Group id. Set to null for unassigned

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/bootstrapkeylist

GET /api/v2/bootstrapkeylist

Get bootstrap keys

Documentation
Sandbox

Documentation

Get bootstrap keys

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

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 device_id is set - return count of CVE for that host

Parameters

Parameter	Type	Required?	Format	Description
device_id	string	false		Device id
limit	integer	false		Maximum number of records, default 5, max 100

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

/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.

NOTE: we apply ALL uncommitted changes, but show affected hosts only for the last change.

Requirements

Name	Type	Description
node_id	string	node or 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

POST /api/v2/change

Add new change to the configuration

Documentation
Sandbox

Documentation

Add new change to the configuration

Requirements

Name	Type	Description
node_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/{sha}

DELETE /api/v2/change/{sha}

Delete single uncommitted change by sha. You can delete only config changes

Documentation
Sandbox

Documentation

Delete change by sha - only uncommitted. You can delete only config changes

Requirements

Name	Requirement	Type	Description
sha

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

GET /api/v2/change/{sha}

Get change - return change by sha

Documentation
Sandbox

Documentation

Get change

Requirements

Name	Requirement	Type	Description
sha		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

/api/v2/changes

DELETE /api/v2/changes

Delete all uncommitted changes

Documentation
Sandbox

Documentation

Delete all uncommitted changes

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

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/{sha}

GET /api/v2/commit/{sha}

Get commit - return commit by id. We support full sha or at least 6 first characters

Documentation
Sandbox

Documentation

Get commit

Requirements

Name	Requirement	Type	Description
sha		string	Commit SHA, could be a substring with 6+ characters
report_type		string	Repot type - detailed or short. Short by default

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_sha - commit sha - full string or substring with at least 6 characters
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_sha - change sha - full string or substring with at least 6 characters
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
type
message
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/{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?	Format	Description
name	string	false		Name of company

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?	Format	Description
name	string	true		Name of company
support_access	bool	false		Support access. False by default

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

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/{node_id}

GET /api/v2/configpreview/{node_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
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

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

File

/api/v2/file

DELETE /api/v2/file

Delete directory or file specified by path.

Documentation
Sandbox

Documentation

Delete directory or file specified by path if item is a directory - we check if it is empty. You can not delete Non-empty directories

Requirements

Name	Requirement	Type	Description
path		string	Full path to directory or file

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

GET /api/v2/file

Upload a file.

Documentation
Sandbox

Documentation

Download a file specified by full path

Requirements

Name	Requirement	Type	Description
path		string	File path

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if bad request - validation error for example
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/file

Rename a file

Documentation
Sandbox

Documentation

Rename file

Requirements

Name	Requirement	Type	Description
name		string	Name
path		string	Original path

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

POST /api/v2/file

Upload a file. Expected content type - multipart/form-data

Documentation
Sandbox

Documentation

Upload a file. Expected content type - multipart/form-data path variable is also required. Path MUST contain leading and ending slashes, for example, if file is uploaded to the bbb folder => /aa/bb/

NOTE: API sandbox doesn't support file upload. Please use cURL.

example:

curl --digest -u [user@email]:[password] -i -X POST -H "Content-Type: multipart/form-data" -F "path=[path_to_upload_starting_with /]" -F "file=@[local_file_to_upload]" https://www.app.qbee.io/api/v2/file

This would upload qbee_example.conf file to the root folder of your storage:

curl --digest -u user@example.com:superstrongpassword -i -X POST -H "Content-Type: multipart/form-data" -F "path=/" -F "file=@qbee_example.conf" https://www.app.qbee.io/api/v2/file

Requirements

Name	Requirement	Type	Description
file		binary file	File

Status Codes

Status Code	Description
200	Returned when successful
400	Returned if bad request - validation error for example
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/file/createdir

POST /api/v2/file/createdir

Create directory

Documentation
Sandbox

Documentation

Create directory

Requirements

Name	Requirement	Type	Description
name		string	Directory name
path		string	Directory path

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/file/stats

GET /api/v2/file/stats

Files statistics (space used (Mb), quota (Mb) and more)

Documentation
Sandbox

Documentation

File statistics

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

/api/v2/files

GET /api/v2/files

Get list of uploaded files

Documentation
Sandbox

Documentation

Get list of uploaded files

Supported search fields:

name - substring

Supported sort fields:

name - alphabetical
size - numeric
created - numeric

Note:

if path is empty and search is empty - show files from the root folder
if path is empty and search is not empty - search in ALL files
if path is not empty and search is empty - show files from that directory
if path is not empty and search is not empty - search in that folder only

Requirements

Name	Type	Description
path	string	Directory to show or search. If empty - root will be used. If search is not empty and path is empty - we search in all folders
search	json	Search conditions. Supported fields: ^see description on top
sort_field	string	Field to sort, name by default
sort_direction	string	Sort direction, asc by default
items_per_page	integer	Maximum number of records in result, default 50, 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

Show/hide List Operations Expand Operations

Group

/api/v2/groupreportssummary/{group_id}

GET /api/v2/groupreportssummary/{group_id}

Get group or device reports statistics (how many info, warn, err, crit) reprots for the last month, week and day

Documentation
Sandbox

Documentation

Get group reports summary

Requirements

Name	Requirement	Type	Description
group_id		string	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

Group tree

/api/v2/grouptree

GET /api/v2/grouptree

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/grouptree

Update tree.

Documentation
Sandbox

Documentation

Update group.

Allowed actions:

create (group only)
rename (group only)
delete [group only]
move

We expect array of changes with the structure like:

Create group: {'action:'create', data{'parent_id':'root', 'node_id':'YYY', 'title':'some_title', 'type':'group', 'position':0}}

Rename group: {'action:'rename', data{'parent_id':'root', 'node_id':'YYY', 'new_title':'my new title'}}

Delete group: (note group mysr be empty) {'action:'delete', data{'parent_id':'root', 'node_id':'YYY'}}

Move group: {'action:'move', data{'new_parent_id': new_parent_id, 'old_parent_id':'old_parent_id', 'node_id':'YYY', 'position': 3}}

Requirements

Name	Requirement	Type	Description
changes		json	Array of changes.

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/grouptree/refreshtree

GET /api/v2/grouptree/refreshtree

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

/api/v2/grouptree/{node_id}

GET /api/v2/grouptree/{node_id}

Get group node info. If group - info about the node and child devices. If device - very short info about device

Documentation
Sandbox

Documentation

Get group devices

Requirements

Name	Requirement	Type	Description
node_id		string	Group id or device 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

Inventory

/api/v2/inventory

GET /api/v2/inventory

Get devices list

Documentation
Sandbox

Documentation

Get list of devices

Supported search fields:

node_id - device node id
uuid - device uuid
title - fqhost, remoteaddr or device title (can be set in the attributes)
flavor - OS flavor
arch - os architecture
ip - ipv4_first, ip_addresses, remoteaddr or ipv4 fields from inventory (exact match)
description - device description - can be set in the attributes
latitude - can be set in the attributes
longitude - can be set in the attributes
country - can be set in the attributes
city - can be set in the attributes
zip - can be set in the attributes
address - can be set in the attributes
device_attribute - in this case we will search in the flavor, architecture, description, lat/long, country, city, zip, address, ipv4_first, ip_addresses, remoteaddr, ipv4 using OR condition and substring match
ancestor_ids - array of node_ids of the parent group (any level) where device should be placed.

NOTE:
- if "root" is specified we return unassigned hosts in addition to others
- To get unassigned hosts - use "unassigned_group" as one of the ancestor_ids array items
commit_sha - commit sha which is on device or scheduled to be pushed to the device. At least 6 characters. Search starts from the beginning of the string

NOTE:
- we require that search value should be at least 3 characters long. Commit sha - at least 6.

Supported sort fields:

title (fqhost or remoteaddr - depending on what is available)
device_name (from attribute)
last_reported_time
last_policy_update
active_config_commit_sha (commit which is scheduled for the device. It will be equal to the device_config_commit_sha once device receive it )

Parameters

Parameter	Type	Required?	Description
search	array	false	Search criteria. See description on top
report_type	string	false	short ir detailed report. allowed: short, detailed. Default: detailed
items_per_page	integer	false	Maximum number of records in result, default 30, max 10000
offset	integer	false	Offset
sort_field	string	false	Field to sort, title by default
sort_direction	string	false	Sort direction, asc by default

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/inventory/{device_id}

DELETE /api/v2/inventory/{device_id}

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

Documentation
Sandbox

Documentation

Delete device

Requirements

Name	Requirement	Type	Description
device_id		string	Device id

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/{device_id}

Get inventory information about device

Documentation
Sandbox

Documentation

Get device inventory information

Requirements

Name	Requirement	Type	Description
device_id		string	device 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/inventorylist

GET DEPRECATED /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. Default 1000. Maximum: 10 000
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/inventoryonlinestats

GET /api/v2/inventoryonlinestats

Return how many devices registered and how many are offline

Documentation
Sandbox

Documentation

Return how many devices registered and how many are offline

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

/api/v2/inventoryreport/{device_id}

GET /api/v2/inventoryreport/{device_id}

Get inventory report for the device

Documentation
Sandbox

Documentation

Get device inventory report

Requirements

Name	Requirement	Type	Description
device_id		string	device 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/inventorysummarybytype/{node_id}

GET /api/v2/inventorysummarybytype/{node_id}

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
node_id		string	device or group id
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

/api/v2/metric/{device_id}/filesystem

GET /api/v2/metric/{device_id}/filesystem

Get return traffic info for the last day, week, month

Documentation
Sandbox

Documentation

Get filesystem_use, filesystem_avail info

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
422	Returned if requested ID is group and it doesn't contain devices as children
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/metric/{node_id}

GET /api/v2/metric/{node_id}

Get metrics by type (cpu/mem/filesystem/load average) for the device or group

Documentation
Sandbox

Documentation

Get metrics by type (cpu/mem/filesystem/load average) for the device or group

Supported search fields:

start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default 30 min from now
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default now

Supported type fields:

cpu_user
cpu_system
cpu_iowait
filesystem_use
filesystem_avail
memory_swaputil
memory_memutil
memory_memfree
loadavg (load average 1mim, 5min, 15min)
network (rx per interface, tx per interface, total for all interfaces rx+tx)

NOTE: We output metrics results per device. This mean that classical offset and items_per_device works differently

offset parameter will be applied inside each device metric values. For example: if without offset you have 25 values for a host, you applied offset of 20 you will get only 5 values for that host.
items_per_device will be applied inside each device metric values limiting how many metrics results you get

NOTE: total shows how many results you can get for the time interval and grouping you specified. This mean that if you do not specify limit or offset the total will be equal to the result set

NOTE: network output is different compare to others. It contains results and totals per interface of the device

Requirements

Name	Type	Description
node_id	string	Device or group ID
type	string	Measurement type, supported: cpu_user, cpu_system ... ^see description on top
with_count	boolean	Return total available records withput limit and offset. This would make query slower. False by default

Parameters

Parameter	Type	Required?	Description
search	json	false	Search conditions. Supported fields: ^see description on top
group_by_time	integer	false	Group by time interval. ALL points for the start/end interval would be grouped into the time buckets. Supported minutes and hours. Format: Xm (20m), Xh (4h)
items_per_device	integer	false	Maximum number of records in single device result, default 1000, max 10000.
offset	integer	false	Offset in single device result. Default 0

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
422	Returned if requested ID is group and it doesn't contain devices as children
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/metric/{node_id}/top

GET /api/v2/metric/{node_id}/top

Get top load for cpu/mem/filesystem for the device or group by period

Documentation
Sandbox

Documentation

Get top load for cpu/mem/filesystem for the device or group by period

Supported search fields:

start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default 30 min from now
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default now

NOTE: if only one device_id provided in array, we check if it is a group id, and in this case - we search withing a group.

Requirements

Name	Requirement	Type	Description
node_id		string	Device or group ID

Parameters

Parameter	Type	Required?	Format	Description
search	json	false		Search conditions. Supported fields: ^see description on top
limit	integer	false		Limit result number. Default: 5. Max allowed 1000

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
422	Returned if requested ID is group and it doesn't contain devices as children
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/metric/{node_id}/topdetailed

GET /api/v2/metric/{node_id}/topdetailed

Get top load for cpu/mem/filesystem for the device or group by period detailed

Documentation
Sandbox

Documentation

Get top load for cpu/mem/filesystem for the devices inside the group.

Supported search fields:

start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default 30 min from now
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48). Default now

NOTE: if only one device_id provided in array, we check if it is a group id, and in this case - we search withing a group.

Requirements

Name	Requirement	Type	Description
node_id		string	group ID

Parameters

Parameter	Type	Required?	Description
search	json	false	Search conditions. Supported fields: ^see description on top
limit	integer	false	Limit how many top devices would be selected. Default: 5. Max allowed 1000
group_by_time	integer	false	Group by time interval. ALL points for the start/end interval would be grouped into the time buckets. Supported minutes and hours. Format: Xm (20m), Xh (4h)
items_per_device	integer	false	Maximum number of records in single device result, default 1000, max 10000.
offset	integer	false	Offset in single device result. Default 0

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
422	Returned if requested ID is group and it doesn't contain devices as children
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/metric/{node_id}/traffic

GET /api/v2/metric/{node_id}/traffic

Get return traffic info for the last day, week, month

Documentation
Sandbox

Documentation

Get traffic info for the last day, week, month

Requirements

Name	Requirement	Type	Description
node_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
422	Returned if requested ID is group and it doesn't contain devices as children
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

Node

/api/v2/node/{node_id}

GET /api/v2/node/{node_id}

Get info about the node. if id is device - return short device info, if group - reports group summary

Documentation
Sandbox

Documentation

Get info about the node. if id is device - return short device info, if group - reports group summary

Requirements

Name	Requirement	Type	Description
node_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

Package

/api/v2/packagelist

GET /api/v2/packagelist

Get a list of packages. Return the last versions available for each package by default.

Documentation
Sandbox

Documentation

Get a 'list of packages. Return the last versions available for each package by default.

Supported search fields:

version - package version
package_title - qbee internal file name
package_name - file name
type - package type (agent or connect)

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

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. Default: 1000. Maximum 10 000
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
node_id	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/{node_id}

DELETE /api/v2/pendinghost/{node_id}

Reject host

Documentation
Sandbox

Documentation

Reject host

Requirements

Name	Requirement	Type	Description
node_id

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/{node_id}

DELETE /api/v2/removeapprovedhost/{node_id}

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
node_id

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

Pushed device config

/api/v2/pushed/{sha}/device/config

GET /api/v2/pushed/{sha}/device/config

Return pushed device config by commit id. SUPER ADMIN ONLY

Documentation
Sandbox

Documentation

Get pushed configs by commit id. SUPER ADMIN ONLY

Requirements

Name	Requirement	Type	Description
sha		string	Commit SHA, could be a substring with 6+ characters

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

Remote console

/api/v2/remoteconsoletoken/{device_id}

GET /api/v2/remoteconsoletoken/{device_id}

Get remote console token

Documentation
Sandbox

Documentation

Get remote console token

Requirements

Name	Requirement	Type	Description
device_id		string	Device id

Parameters

Parameter	Type	Required?	Format	Description
username	string	false		Username to login with

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

Report

/api/v2/reportlist

GET /api/v2/reportlist

Get reports

Documentation
Sandbox

Documentation

Get reports

Supported search fields:

NOTE: Report item has field "commit_id" which shows the LATEST commit for the whole device. It is not related to the commit where actual config change was declared, and for which change this report is about.

For example: user created a commit with id: AAA for the NTP configuration, then user created some more commits: BBB - ssh settings, CCC - firewall. When agent would report about the status of applying the NTP settings, it will use CCC as a commit_id, because CCC is the last (newest) commit which triggered configuration regeneration. (we regenerate config for all devices, even if change was only for subgroup)

In order to get reports for the actual change from AAA commit use bundle_commit_id field. The value there is equal to the one of the changes in the AAA commit.

To get reports for all changes in commit - use commit_sha_real. For that we first find the changes which declared in the commit, and then collect reports for all changes in it.

report_id - id of the report (exact match)
bundle_commit_id - array of ids of the change (sha) (exact match)
commit_sha_real - (!) return reports where bundle_commit_id field is equal to one of the items in the change array of commit. See note above about commit_id.
pub_key_digest - array of the devices id (exact match)
title - hostname or device name (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"]. If not set - return all severities available. If empty array - nothing will be selected
start_date - Start date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48)
end_date - End date UTC, format: YYYY-MM-DD hh:ii:ss (2019-03-18 10:35:48)

Supported sort fields:

title - host title (alphabetical)
device_name - device name with fallback to host title (alphabetical)
pub_key_digest (alphabetical)
severity (alphabetical)
labels (alphabetical)
ts (integer)
reports_count (integer, only in group_mode=true)
bundle_commit_id (alphabetical)

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
group_mode	boolean	false	Group simmilar items (deduplication), default false

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 by report id or by unique group criteria. Criteria must contain: bundle_commit_id, severity, pub_key_digest, labels, text, start_ts, end_ts

Documentation
Sandbox

Documentation

Mark report(s) as read

by report id
by unique group criteria. Criteria must contain: commit_id, bundle_commit_id, severity, pub_key_digest, labels, text, start_ts, end_ts

Parameters

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

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/{device_id}

GET /api/v2/reportsummary/{device_id}

Get reports summary per device or group

Documentation
Sandbox

Documentation

Get reports summary (hom many info, warn, err, crit reports per period) per device or group. Limit - 1 year

Requirements

Name	Requirement	Type	Description
device_id		string	Device or group ID

Parameters

Parameter	Type	Required?	Format	Description
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

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

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 Note: - Company will be set equal to the user who sends request - After creating a user, email can only be changed by super admin.

Parameters

Parameter	Type	Required?	Description
fname	string	true	First name
lname	string	true	Last name
email	string	true	Email
password	string	true	Password
service_agree	boolean	true	Service agreement agree, expected 1 or true
enabled	boolean	false	Set if user is enabled (defult false)
console_access	boolean	false	Set if user should have a console access
roles	json	false	Array of user roles. Supported: ROLE_ADMIN. Default: empty. Example input: [ "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/confirmmail/{token}

GET /api/v2/user/confirmmail/{token}

Confirm registration email

Documentation
Sandbox

Documentation

Confirm registration email

Requirements

Name	Requirement	Type	Description
token

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

Requirements

= -

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

API documentation - qbee.io

Analysis

/api/v2/analysis

GET /api/v2/analysis

Documentation

Parameters

Status Codes

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Bootstrap

/api/v2/bootstrapkey

POST /api/v2/bootstrapkey

Documentation

Status Codes

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/bootstrapkey/{bootstrap_key}

DELETE /api/v2/bootstrapkey/{bootstrap_key}

Documentation

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/v2/bootstrapkey/{bootstrap_key}

Documentation

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PUT /api/v2/bootstrapkey/{bootstrap_key}

Documentation

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

/api/v2/bootstrapkeylist

GET /api/v2/bootstrapkeylist

Documentation

Status Codes

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

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}