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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

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

NameTypeDescription

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": "user@example.com"
    }
}

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

NameTypeDescription

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": "user@example.com",
                "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

NameTypeDescription

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": "user@example.com"
    },
    "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

NameTypeDescription

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

NameTypeDescription

id*

integer

ID of the acknowledged issue to delete.

{
    "success": 1
}

Last updated