# 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"}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"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"}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"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"}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"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"}},"required":["id","name","server_names","security_policy","routing_profile","proxy_template","challenge_cookie_domain"]},"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"}}}}
```