# Backend Services
## Get Backend Services
> Get all Backend Services in a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services":{"get":{"operationId":"document_resource_get_api_v3_configs__config__d__document___get_917981194030078625","summary":"Get Backend Services","description":"Get all Backend Services in a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"responses":{"200":{"description":"Backend Services retrieved successfully","content":{"application/json":{"schema":{"title":"Backend Services document","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/BackendService"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Services
> Updates an existing set of Backend Services for a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services":{"put":{"operationId":"document_resource_put_api_v3_configs__config__d__document___put_917981194030078625","summary":"Modify Backend Services","description":"Updates an existing set of Backend Services for a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"title":"Backend Services document","type":"array","items":{"$ref":"#/components/schemas/BackendService"}}}}},"responses":{"200":{"description":"Backend Services updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Services
> Create a complete set of Backend Services for a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services":{"post":{"operationId":"document_resource_post_api_v3_configs__config__d__document___post_917981194030078625","summary":"Create Backend Services","description":"Create a complete set of Backend Services for a configuration","parameters":[{"in":"path","name":"config","required":true,"schema":{"title":"Config","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"title":"Backend Services document","type":"array","items":{"$ref":"#/components/schemas/BackendService"}}}}},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreate"}}},"description":"Backend Services created successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Services
> Delete all Backend Services in a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services":{"delete":{"operationId":"document_resource_delete_api_v3_configs__config__d__document___delete_917981194030078625","summary":"Delete Backend Services","description":"Delete all Backend Services 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":"Backend Services deleted successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"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 Backend Service
> Get an individual Backend Service from the specified configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/{entry_id}":{"get":{"operationId":"entry_resource_get_api_v3_configs__config__d__document__e__entry___get_2039370200812113407","summary":"Get single Backend Service","description":"Get an individual Backend Service 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":"Backend Service retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackendService"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Service
> Update an individual Backend Service within a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/{entry_id}":{"put":{"operationId":"entry_resource_put_api_v3_configs__config__d__document__e__entry___put_2039370200812113407","summary":"Modify a single Backend Service","description":"Update an individual Backend Service 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/BackendService"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseUpdate"}}},"description":"Backend Service updated successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Service
> Create an individual Backend Service within a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/{entry_id}":{"post":{"operationId":"entries_resource_post_api_v3_configs__config__d__document__e__post_1682546273078263211","summary":"Create single Backend Service","description":"Create an individual Backend Service 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/BackendService"}}}},"responses":{"201":{"description":"Backend Service created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreate"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 Backend Service
> Delete an individual Backend Service from the specified configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/{entry_id}":{"delete":{"operationId":"entry_resource_delete_api_v3_configs__config__d__document__e__entry___delete_2039370200812113407","summary":"Delete single Backend Service","description":"Delete an individual Backend Service 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":"Backend Service deleted successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"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 Backend Services version list
> Get list of versions of Backend Services in a configuration
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/versions":{"get":{"operationId":"document_list_version_resource_get_api_v3_configs__config__d__document__v__get_1064601299435648815","summary":"Get Backend Services version list","description":"Get list of versions of Backend Services 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":"Backend Services version list retrieved successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"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 Backend Service
> Get a specific version of a Backend Service
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/versions/{version}":{"get":{"operationId":"document_version_resource_get_api_v3_configs__config__d__document__v__version___get_1317216686524434426","summary":"Get version of Backend Service","description":"Get a specific version of a Backend Service","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":"Backend Services document","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"$ref":"#/components/schemas/BackendService"}}}}}},"description":"Backend Service retrieved successfully"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"components":{"schemas":{"BackendService":{"properties":{"back_hosts":{"items":{"$ref":"#/components/schemas/BackendHost"},"title":"Back Hosts","type":"array"},"description":{"anyOf":[{"type":"string"}],"default":"","title":"Description"},"http11":{"description":"Use HTTP/1.1","title":"Http11","type":"boolean"},"id":{"title":"Id","type":"string"},"least_conn":{"title":"Least Conn","type":"boolean"},"name":{"title":"Name","type":"string","minLength":1},"sticky":{"description":"Load Balancing stickiness model","enum":["none","autocookie","customcookie","iphash","least_conn"],"title":"Sticky","type":"string"},"sticky_cookie_name":{"anyOf":[{"type":"string"}],"default":"","description":"Custom cookie name","title":"Sticky Cookie Name"},"transport_mode":{"description":"Tranport protocol
Service connectivity might follow incoming requests, will always be HTTP, or always HTTPS. Port-bridge mode means that Reblaze will target port numbers identical to incoming requests' port numbers.","enum":["default","http","https","port_bridge"],"title":"Transport Mode","type":"string"},"mtls_certificate":{"type":"string","description":"ID of mTLS certificate attached to backend service","title":"mTLS Certificate"},"mtls_trusted_certificate":{"type":"string","description":"ID of CA certificate attached to backend service","title":"CA Certificate"}},"required":["id","name","http11","transport_mode","sticky","sticky_cookie_name","least_conn","back_hosts"],"title":"BackendService","type":"object"},"BackendHost":{"properties":{"backup":{"title":"Backup","type":"boolean"},"down":{"title":"Down","type":"boolean"},"fail_timeout":{"title":"Fail Timeout","type":"integer"},"host":{"description":"URI or IP of host","title":"Host","type":"string"},"http_ports":{"title":"Http Ports","type":"array","items":{"type":"integer"}},"https_ports":{"title":"Https Ports","type":"array","items":{"type":"integer"}},"max_fails":{"title":"Max Fails","type":"integer"},"monitor_state":{"title":"Monitor State","type":"string"},"weight":{"title":"Weight","type":"integer"}},"required":["host","http_ports","https_ports","weight","max_fails","fail_timeout","down","monitor_state","backup"],"title":"BackendHost","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 a Backend Service to the specified version
> Set a previous Backend Service version to be the current one
```json
{"openapi":"3.0.2","info":{"title":"Link11 WAAP","version":"v4.3"},"paths":{"/api/v4.3/conf/{config}/backend-services/versions/{version}/revert":{"put":{"operationId":"document_revert_resource_put_api_v3_configs__config__d__document__v__version__revert__put_452516142452866822","summary":"Revert a Backend Service to the specified version","description":"Set a previous Backend Service version to be the current one","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":"Backend Service reversion was successful"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"tags":["Backend Services"]}}},"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/backend-services.md?ask=
```
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.