# 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"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://waap.docs.link11.com/reference-information/api/namespace-reference/security-alerts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.