Acknowledged
The Acknowledged endpoint allows you to list, add, and delete acknowledged hostnames, apps, and issues.
Get a list of acknowledged hostnames.
GET
https://api.halosecurity.com/api/v1/ack/host-list.json
Returns a paginated list of acknowledged hostnames.
https://www.halosecurity.com/user/security/awk/hosts
{
"list": [
{
"awk_host": {
"host": "0.0.0.0",
"comment": "Randomly scans its-self causing massive fps.",
"created_date": "0000-00-00 00:00",
"type": 1000,
"created_by": "example"
}
}
]
}
Add a hostname acknowledgment.
GET
https://api.halosecurity.com/api/v1/ack/host-add.json
Requires the security_acknowledge_add
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/hosts
Query Parameters
host*
String
type*
String
global
discovery
cookie
script
form
cert
download
link
traffic
comment
String
{
"success": 1
}
Delete a hostname acknowledgment.
GET
https://api.halosecurity.com/api/v1/ack/host-delete.json
Requires the security_acknowledge_delete
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/hosts
Query Parameters
host*
String
type
String
global
discovery
cookie
script
form
cert
download
link
traffic
{
"success": 1
}
Get a list of acknowledged elements.
GET
https://api.halosecurity.com/api/v1/ack/element-list.json
Returns a paginated list of acknowledged elements. See the Appendix for information about acceptable element types.
See the Appendix for information about acceptable element types.
https://www.halosecurity.com/user/security/awk/apps
Query Parameters
type*
Integer
Type of element to list
{
"request": {
"target_count": 27,
"sort": "1"
},
"pagination": {
"total": 0,
"start": 0,
"limit": 100
},
"list": [
{
"awk_app": {
"name": "Cloudflare",
"created_date": "0000-00-00 00:00",
"app_id": 14,
"created_by": "none"
}
}
]
}
Add an app acknowledgment.
GET
https://api.halosecurity.com/api/v1/ack/element-add.json
Add an acknowledged element. See the Appendix for information about acceptable element types.
Requires the security_acknowledge_add
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/apps
Query Parameters
type*
Integer
Type of element to add
{
"success": 1
}
Get information about a specific acknowledgement.
GET
https://api.halosecurity.com/api/v1/ack/element-get.json
Query Parameters
id*
Integer
ID of the acknowledgement to get
{
"success": 1,
"ack_element": {
"comment": "test",
"target_id": 0,
"created_date": "2022-05-27 17:49",
"created_by": "[email protected]"
}
}
Delete an element acknowledgment.
GET
https://api.halosecurity.com/api/v1/ack/element-delete.json
Requires the security_acknowledge_delete
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/apps
Query Parameters
id*
Integer
ID of the acknowledgement to delete
{
"success": 1
}
Get a list of acknowledged issues.
GET
https://api.halosecurity.com/api/v1/ack/issue-list.json
https://www.halosecurity.com/user/security/awk/issues
{
"request": {
"target_count": 1,
"sort": "1"
},
"pagination": {
"total": 1,
"start": 0,
"limit": 100
},
"list": [
{
"ack_issue": {
"reason": 1,
"last_found_date": "2022-01-01 12:00",
"issue_id": 12345,
"target_id": 0,
"id": 1234,
"created_date": "2022-01-01 12:00",
"created_by": "[email protected]",
"last_found_scan_id": "202201011200J344j0mFFFFZv0J0000"
}
}
]
}
Get information about a specific acknowledged issue.
GET
https://api.halosecurity.com/api/v1/ack/issue-get.json
https://www.halosecurity.com/user/security/awk/issues
Query Parameters
id*
integer
ID of the acknowledged issue.
{
"ack_issue": {
"reason": 1,
"issue_id": 12345,
"target_id": 0,
"id": 1234,
"created_date": "2022-01-01 12:00",
"created_by": "[email protected]"
},
"success": 1
}
Add an issue to acknowledged list.
GET
https://api.halosecurity.com/api/v1/ack/issue-add.json
Requires the security_acknowledge_add
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/issues
Query Parameters
issue_id*
integer
ID of the issue to add.
{
"success": 1,
"id": 12345
}
Delete an acknowledged issue.
GET
https://api.halosecurity.com/api/v1/ack/issue-delete.json
Requires the security_acknowledge_delete
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/security/awk/issues
Query Parameters
id*
integer
ID of the acknowledged issue to delete.
{
"success": 1
}
Last updated
Was this helpful?