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
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
Name | Type | Description |
---|---|---|
host* | String | |
type* | String |
|
comment | String |
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
Name | Type | Description |
---|---|---|
host* | String | |
type | String |
|
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
Name | Type | Description |
---|---|---|
type* | Integer | Type of element to list |
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
Name | Type | Description |
---|---|---|
type* | Integer | Type of element to add |
Get information about a specific acknowledgement.
GET
https://api.halosecurity.com/api/v1/ack/element-get.json
Query Parameters
Name | Type | Description |
---|---|---|
id* | Integer | ID of the acknowledgement to get |
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
Name | Type | Description |
---|---|---|
id* | Integer | ID of the acknowledgement to delete |
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
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
Name | Type | Description |
---|---|---|
id* | integer | ID of the acknowledged issue. |
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
Name | Type | Description |
---|---|---|
issue_id* | integer | ID of the issue to add. |
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
Name | Type | Description |
---|---|---|
id* | integer | ID of the acknowledged issue to delete. |
Last updated