> For the complete documentation index, see [llms.txt](https://waap.docs.link11.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://waap.docs.link11.com/reference-information/api/namespace-reference/security-alerts.md).

# Security Alerts

## Get Security Alerts

> Get all Security Alerts in a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts":{"get":{"operationId":"document_resource_get_api_v3_configs__config__d__document___get_920494197590142712","summary":"Get Security Alerts","description":"Get all Security Alerts in a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"responses":{"200":{"description":"Security Alerts retrieved successfully","content":{"application/json":{"schema":{"title":"Security Alerts document","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SecurityAlert"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Modify Security Alerts

> Update an existing set of Security Alerts for a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts":{"put":{"operationId":"document_resource_put_api_v3_configs__config__d__document___put_920494197590142712","summary":"Modify Security Alerts","description":"Update an existing set of Security Alerts for a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"title":"Security Alerts document","type":"array","items":{"$ref":"#/components/schemas/SecurityAlert"}}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}},"description":"Security Alerts updated successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"ResponseUpdate":{"title":"ResponseUpdate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful update operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Create Security Alerts

> Create complete set of Security Alerts for a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts":{"post":{"operationId":"document_resource_post_api_v3_configs__config__d__document___post_920494197590142712","summary":"Create Security Alerts","description":"Create complete set of Security Alerts for a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"title":"Security Alerts document","type":"array","items":{"$ref":"#/components/schemas/SecurityAlert"}}}}},"responses":{"201":{"description":"Security Alerts created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreate"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"ResponseCreate":{"title":"ResponseCreate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful create operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Delete Security Alerts

> Delete all Security Alerts in a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts":{"delete":{"operationId":"document_resource_delete_api_v3_configs__config__d__document___delete_920494197590142712","summary":"Delete Security Alerts","description":"Delete all Security Alerts in a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDelete"}}},"description":"Security Alerts deleted successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"ResponseDelete":{"title":"ResponseDelete","type":"object","properties":{"message":{"title":"Message","description":"Information about successful delete operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Get single Alert

> Get an individual Alert from the specified configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/{entry_id}":{"get":{"operationId":"entry_resource_get_api_v3_configs__config__d__document__e__entry___get_188924675493220040","summary":"Get single Alert","description":"Get an individual Alert from the specified configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"title":"Entry","type":"string"}}],"responses":{"200":{"description":"Alert retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecurityAlert"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Modify a single Alert

> Update an individual Alert within a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/{entry_id}":{"put":{"operationId":"entry_resource_put_api_v3_configs__config__d__document__e__entry___put_188924675493220040","summary":"Modify a single Alert","description":"Update an individual Alert within a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"title":"Entry","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecurityAlert"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}},"description":"Alert updated successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"ResponseUpdate":{"title":"ResponseUpdate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful update operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Create single Alert

> Create an individual Alert within a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/{entry_id}":{"post":{"description":"Create an individual Alert within a configuration","operationId":"entries_resource_post_api_v3_configs__config__d__document__e__post_1233211825730707681","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"title":"Entry","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecurityAlert"}}}},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreate"}}},"description":"Alert created successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Create single Alert","tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"ResponseCreate":{"title":"ResponseCreate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful create operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Delete single Alert

> Delete an individual Alert from the specified configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/{entry_id}":{"delete":{"operationId":"entry_resource_delete_api_v3_configs__config__d__document__e__entry___delete_188924675493220040","summary":"Delete single Alert","description":"Delete an individual Alert from the specified configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"title":"Entry","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDelete"}}},"description":"Alert deleted successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"ResponseDelete":{"title":"ResponseDelete","type":"object","properties":{"message":{"title":"Message","description":"Information about successful delete operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Get Security Alerts version list

> Get list of versions of Security Alerts in a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/versions":{"get":{"operationId":"document_list_version_resource_get_api_v3_configs__config__d__document__v__get_2192084746238710671","summary":"Get Security Alerts version list","description":"Get list of versions of Security Alerts in a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"title":"Versions list","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/VersionEntry"}}}}}},"description":"Security Alerts version list retrieved successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"VersionEntry":{"title":"VersionEntry","type":"object","properties":{"author":{"title":"Author","type":"string"},"email":{"title":"Email","format":"email","type":"string"},"message":{"title":"Message","type":"string"},"date":{"format":"date-time","title":"Date","type":"string"},"version":{"title":"Version","type":"string"},"parents":{"type":"array","items":{"type":"string"}}}},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Get version of Security Alerts

> Get a specific version of an Alert

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/versions/{version}":{"get":{"operationId":"document_version_resource_get_api_v3_configs__config__d__document__v__version___get_2213417477955538928","summary":"Get version of Security Alerts","description":"Get a specific version of an Alert","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"version","required":true,"schema":{"title":"Version","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"title":"Security Alerts document","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SecurityAlert"}}}}}},"description":"Alert version retrieved successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Security Alerts"]}}},"components":{"schemas":{"SecurityAlert":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"minLength":1,"title":"Name","type":"string"},"server_groups":{"title":"Server Groups","description":"List of attached Server Group IDs","type":"array","items":{"type":"string"}},"dynamic_rules":{"title":"Dynamic Rules","description":"List of attached Dynamic Rule IDs","type":"array","items":{"type":"string"}},"recipients":{"title":"Recipients","type":"array","items":{"type":"string","format":"email"},"minItems":1}},"required":["id","name","server_groups","dynamic_rules","recipients"],"title":"Security Alert","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```

## Revert Security Alerts to the specified version

> Set a previous Security Alerts version to be the current one

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/security-alerts/versions/{version}/revert":{"put":{"description":"Set a previous Security Alerts version to be the current one","operationId":"document_revert_resource_put_api_v3_configs__config__d__document__v__version__revert__put_2219093287643266132","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"version","required":true,"schema":{"title":"Version","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}},"description":"Security Alerts reversion was successful"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Revert Security Alerts to the specified version","tags":["Security Alerts"]}}},"components":{"schemas":{"ResponseUpdate":{"title":"ResponseUpdate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful update operation","type":"string"}},"required":["message"]},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"}}}}
```