# Server Groups

## Get all Server Groups (sites/domains)

> Get all Server Groups in a configuration. (Usually, each Server Group represents a site or domain.)

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/server-groups":{"get":{"operationId":"get_api_v3_reblaze_configs__config__d_sites__get_2100786203846410586","summary":"Get all Server Groups (sites/domains)","description":"Get all Server Groups in a configuration. (Usually, each Server Group represents a site or domain.)","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"title":"Server Groups document","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Site"}}}}}},"description":"Server Groups retrieved successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputError"}}},"description":"Bad Request"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"tags":["Server Groups"]}}},"components":{"schemas":{"Site":{"title":"Site","type":"object","properties":{"id":{"description":"Unique id","pattern":"^[A-Za-z0-9\\-\\_]*$","title":"Id","type":"string"},"challenge_cookie_domain":{"description":"The domain for a challenge's cookie.","minLength":1,"title":"Challenge's Cookie Domain","type":"string"},"description":{"default":"","title":"Description","type":"string"},"mobile_application_group":{"description":"ID of Mobile Application Group used for site.","title":"Mobile Application Group","type":"string"},"name":{"description":"site name","maxLength":250,"minLength":1,"title":"Name","type":"string"},"proxy_template":{"description":"ID of Proxy template used for site.","title":"Proxy Template","type":"string"},"routing_profile":{"description":"ID of Routing profile used for site.","title":"Routing profile","type":"string"},"security_policy":{"description":"ID of security policy applied on site.","title":"Security Policy","type":"string"},"server_names":{"description":"host names corresponding to the site.","items":{"type":"string"},"title":"Server Names","type":"array"},"ssl_certificate":{"description":"ID of SSL certificate attached to site.","title":"SSL Certificate","type":"string"},"client_certificate":{"description":"ID of SSL client CA certificate attached to site.","title":"SSL Client CA Certificate","type":"string"},"client_certificate_mode":{"description":"Controls how client certificate is checked when mTLS is enabled.","title":"Client certificate mode","enum":["on","off","optional",""],"default":"off","type":"string"},"crl_verify":{"description":"Enable Certificate Revocation List (CRL) validation for client certificates.","title":"CRL Verify","type":"boolean","default":false},"crl":{"description":"List of CRL content bodies.","title":"CRL","type":"array","default":[],"items":{"type":"string"}},"cdp":{"description":"List of CRL Distribution Point URLs.","title":"CDP","type":"array","default":[],"items":{"type":"string"}},"crl_statuses":{"description":"Read-only field returned by the API containing the validation status of each CRL URL. Each item includes the URL, issuer, last check/download/update timestamps, validation status, and any error message. This field is computed server-side and should not be sent in requests.","title":"CRL Statuses","type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CRLStatusItem"}}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"CRLStatusItem":{"properties":{"url":{"title":"URL","type":"string","format":"uri","description":"CRL download URL"},"issuer":{"title":"Issuer","type":"string","nullable":true},"last_check":{"title":"Last Check","type":"string","nullable":true},"last_download":{"title":"Last Download","type":"string","nullable":true},"last_update":{"title":"Last Update","type":"string","nullable":true},"status":{"title":"Status","type":"boolean"},"error":{"title":"Error","type":"string","nullable":true}},"required":["url","status"],"title":"CRLStatusItem","type":"object"},"InputError":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"InputError","type":"object"},"Error":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"Error","type":"object"}}}}
```

## Get a specific Server Group (a specific site/domain)

> Get a Server Group from the specified configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/server-groups/{entry_id}":{"get":{"operationId":"get_one_api_v3_reblaze_configs__config__d_sites_e__id___get_2245526208597929715","summary":"Get a specific Server Group (a specific site/domain)","description":"Get a Server Group 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":"Id","type":"string"}}],"responses":{"200":{"description":"Server Group retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputError"}}},"description":"Bad Request"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"tags":["Server Groups"]}}},"components":{"schemas":{"Site":{"title":"Site","type":"object","properties":{"id":{"description":"Unique id","pattern":"^[A-Za-z0-9\\-\\_]*$","title":"Id","type":"string"},"challenge_cookie_domain":{"description":"The domain for a challenge's cookie.","minLength":1,"title":"Challenge's Cookie Domain","type":"string"},"description":{"default":"","title":"Description","type":"string"},"mobile_application_group":{"description":"ID of Mobile Application Group used for site.","title":"Mobile Application Group","type":"string"},"name":{"description":"site name","maxLength":250,"minLength":1,"title":"Name","type":"string"},"proxy_template":{"description":"ID of Proxy template used for site.","title":"Proxy Template","type":"string"},"routing_profile":{"description":"ID of Routing profile used for site.","title":"Routing profile","type":"string"},"security_policy":{"description":"ID of security policy applied on site.","title":"Security Policy","type":"string"},"server_names":{"description":"host names corresponding to the site.","items":{"type":"string"},"title":"Server Names","type":"array"},"ssl_certificate":{"description":"ID of SSL certificate attached to site.","title":"SSL Certificate","type":"string"},"client_certificate":{"description":"ID of SSL client CA certificate attached to site.","title":"SSL Client CA Certificate","type":"string"},"client_certificate_mode":{"description":"Controls how client certificate is checked when mTLS is enabled.","title":"Client certificate mode","enum":["on","off","optional",""],"default":"off","type":"string"},"crl_verify":{"description":"Enable Certificate Revocation List (CRL) validation for client certificates.","title":"CRL Verify","type":"boolean","default":false},"crl":{"description":"List of CRL content bodies.","title":"CRL","type":"array","default":[],"items":{"type":"string"}},"cdp":{"description":"List of CRL Distribution Point URLs.","title":"CDP","type":"array","default":[],"items":{"type":"string"}},"crl_statuses":{"description":"Read-only field returned by the API containing the validation status of each CRL URL. Each item includes the URL, issuer, last check/download/update timestamps, validation status, and any error message. This field is computed server-side and should not be sent in requests.","title":"CRL Statuses","type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CRLStatusItem"}}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"CRLStatusItem":{"properties":{"url":{"title":"URL","type":"string","format":"uri","description":"CRL download URL"},"issuer":{"title":"Issuer","type":"string","nullable":true},"last_check":{"title":"Last Check","type":"string","nullable":true},"last_download":{"title":"Last Download","type":"string","nullable":true},"last_update":{"title":"Last Update","type":"string","nullable":true},"status":{"title":"Status","type":"boolean"},"error":{"title":"Error","type":"string","nullable":true}},"required":["url","status"],"title":"CRLStatusItem","type":"object"},"InputError":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"InputError","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"},"Error":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"Error","type":"object"}}}}
```

## Modify Server Group (a site/domain)

> Update an individual Server Group within a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/server-groups/{entry_id}":{"put":{"operationId":"update_api_v3_reblaze_configs__config__d_sites_e__id___put_2245526208597929715","summary":"Modify Server Group (a site/domain)","description":"Update an individual Server Group within a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}},"description":"Server Group updated successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputError"}}},"description":"Input Error"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"tags":["Server Groups"]}}},"components":{"schemas":{"Site":{"title":"Site","type":"object","properties":{"id":{"description":"Unique id","pattern":"^[A-Za-z0-9\\-\\_]*$","title":"Id","type":"string"},"challenge_cookie_domain":{"description":"The domain for a challenge's cookie.","minLength":1,"title":"Challenge's Cookie Domain","type":"string"},"description":{"default":"","title":"Description","type":"string"},"mobile_application_group":{"description":"ID of Mobile Application Group used for site.","title":"Mobile Application Group","type":"string"},"name":{"description":"site name","maxLength":250,"minLength":1,"title":"Name","type":"string"},"proxy_template":{"description":"ID of Proxy template used for site.","title":"Proxy Template","type":"string"},"routing_profile":{"description":"ID of Routing profile used for site.","title":"Routing profile","type":"string"},"security_policy":{"description":"ID of security policy applied on site.","title":"Security Policy","type":"string"},"server_names":{"description":"host names corresponding to the site.","items":{"type":"string"},"title":"Server Names","type":"array"},"ssl_certificate":{"description":"ID of SSL certificate attached to site.","title":"SSL Certificate","type":"string"},"client_certificate":{"description":"ID of SSL client CA certificate attached to site.","title":"SSL Client CA Certificate","type":"string"},"client_certificate_mode":{"description":"Controls how client certificate is checked when mTLS is enabled.","title":"Client certificate mode","enum":["on","off","optional",""],"default":"off","type":"string"},"crl_verify":{"description":"Enable Certificate Revocation List (CRL) validation for client certificates.","title":"CRL Verify","type":"boolean","default":false},"crl":{"description":"List of CRL content bodies.","title":"CRL","type":"array","default":[],"items":{"type":"string"}},"cdp":{"description":"List of CRL Distribution Point URLs.","title":"CDP","type":"array","default":[],"items":{"type":"string"}},"crl_statuses":{"description":"Read-only field returned by the API containing the validation status of each CRL URL. Each item includes the URL, issuer, last check/download/update timestamps, validation status, and any error message. This field is computed server-side and should not be sent in requests.","title":"CRL Statuses","type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CRLStatusItem"}}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"CRLStatusItem":{"properties":{"url":{"title":"URL","type":"string","format":"uri","description":"CRL download URL"},"issuer":{"title":"Issuer","type":"string","nullable":true},"last_check":{"title":"Last Check","type":"string","nullable":true},"last_download":{"title":"Last Download","type":"string","nullable":true},"last_update":{"title":"Last Update","type":"string","nullable":true},"status":{"title":"Status","type":"boolean"},"error":{"title":"Error","type":"string","nullable":true}},"required":["url","status"],"title":"CRLStatusItem","type":"object"},"ResponseUpdate":{"title":"ResponseUpdate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful update operation","type":"string"}},"required":["message"]},"InputError":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"InputError","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"},"Error":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"Error","type":"object"}}}}
```

## Create Server Group (a site/domain)

> Create a Server Group within a configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/server-groups/{entry_id}":{"post":{"operationId":"add_api_v3_reblaze_configs__config__d_sites_e__id___post_2245526208597929715","summary":"Create Server Group (a site/domain)","description":"Create a Server Group within a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}},{"in":"path","name":"entry_id","required":true,"schema":{"pattern":"^[A-Za-z0-9\\-\\_]*$","title":"Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Site"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreate"}}},"description":"Server Group created successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputError"}}},"description":"Bad Request"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"tags":["Server Groups"]}}},"components":{"schemas":{"Site":{"title":"Site","type":"object","properties":{"id":{"description":"Unique id","pattern":"^[A-Za-z0-9\\-\\_]*$","title":"Id","type":"string"},"challenge_cookie_domain":{"description":"The domain for a challenge's cookie.","minLength":1,"title":"Challenge's Cookie Domain","type":"string"},"description":{"default":"","title":"Description","type":"string"},"mobile_application_group":{"description":"ID of Mobile Application Group used for site.","title":"Mobile Application Group","type":"string"},"name":{"description":"site name","maxLength":250,"minLength":1,"title":"Name","type":"string"},"proxy_template":{"description":"ID of Proxy template used for site.","title":"Proxy Template","type":"string"},"routing_profile":{"description":"ID of Routing profile used for site.","title":"Routing profile","type":"string"},"security_policy":{"description":"ID of security policy applied on site.","title":"Security Policy","type":"string"},"server_names":{"description":"host names corresponding to the site.","items":{"type":"string"},"title":"Server Names","type":"array"},"ssl_certificate":{"description":"ID of SSL certificate attached to site.","title":"SSL Certificate","type":"string"},"client_certificate":{"description":"ID of SSL client CA certificate attached to site.","title":"SSL Client CA Certificate","type":"string"},"client_certificate_mode":{"description":"Controls how client certificate is checked when mTLS is enabled.","title":"Client certificate mode","enum":["on","off","optional",""],"default":"off","type":"string"},"crl_verify":{"description":"Enable Certificate Revocation List (CRL) validation for client certificates.","title":"CRL Verify","type":"boolean","default":false},"crl":{"description":"List of CRL content bodies.","title":"CRL","type":"array","default":[],"items":{"type":"string"}},"cdp":{"description":"List of CRL Distribution Point URLs.","title":"CDP","type":"array","default":[],"items":{"type":"string"}},"crl_statuses":{"description":"Read-only field returned by the API containing the validation status of each CRL URL. Each item includes the URL, issuer, last check/download/update timestamps, validation status, and any error message. This field is computed server-side and should not be sent in requests.","title":"CRL Statuses","type":"array","readOnly":true,"items":{"$ref":"#/components/schemas/CRLStatusItem"}}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"CRLStatusItem":{"properties":{"url":{"title":"URL","type":"string","format":"uri","description":"CRL download URL"},"issuer":{"title":"Issuer","type":"string","nullable":true},"last_check":{"title":"Last Check","type":"string","nullable":true},"last_download":{"title":"Last Download","type":"string","nullable":true},"last_update":{"title":"Last Update","type":"string","nullable":true},"status":{"title":"Status","type":"boolean"},"error":{"title":"Error","type":"string","nullable":true}},"required":["url","status"],"title":"CRLStatusItem","type":"object"},"ResponseCreate":{"title":"ResponseCreate","type":"object","properties":{"message":{"title":"Message","description":"Information about successful create operation","type":"string"}},"required":["message"]},"InputError":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"InputError","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"},"Error":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"Error","type":"object"}}}}
```

## Delete a Server Group (a site/domain)

> Delete a Server Group from the specified configuration

```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/server-groups/{entry_id}":{"delete":{"operationId":"delete_api_v3_reblaze_configs__config__d_sites_e__id___delete_2245526208597929715","summary":"Delete a Server Group (a site/domain)","description":"Delete a Server Group 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":"Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDelete"}}},"description":"Server Group deleted successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InputError"}}},"description":"Input Error"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Internal Server Error"}},"tags":["Server Groups"]}}},"components":{"schemas":{"ResponseDelete":{"title":"ResponseDelete","type":"object","properties":{"message":{"title":"Message","description":"Information about successful delete operation","type":"string"}},"required":["message"]},"InputError":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"InputError","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"},"Error":{"properties":{"code":{"title":"Code","type":"integer"},"message":{"title":"Message","type":"string"}},"required":["code","message"],"title":"Error","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/server-groups.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.