> For the complete documentation index, see [llms.txt](https://developers.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.incidents.cloud.solarwinds.com/api-reference/services-routing-rules.md).

# Services/Routing Rules

## GET /v3/services/{serviceID}/routing-rules

> Get Routing Rules

```json
{"openapi":"3.1.0","info":{"title":"Squadcast","version":"1.0.0"},"tags":[{"name":"Services/Routing Rules"}],"servers":[{"url":"https://api.squadcast.com","description":"production US env","variables":{}},{"url":"https://api.eu.squadcast.com","description":"production EU env","variables":{}}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"V3.Services.RoutingRules.RoutingRuleResponse":{"type":"object","allOf":[{"$ref":"#/components/schemas/V3.Services.RoutingRules.RoutingRule"}]},"V3.Services.RoutingRules.RoutingRule":{"type":"object","required":["expression","route_to","is_basic"],"properties":{"expression":{"type":"string"},"route_to":{"type":"object","properties":{"entity_type":{"type":"string","enum":["user","squad","escalation_policy"]},"entity_id":{"type":"string"}},"required":["entity_type","entity_id"]},"is_basic":{"type":"boolean"},"basic_expression":{"type":"array","items":{"$ref":"#/components/schemas/V3.Services.RoutingRules.ExpressionBranch"}}}},"V3.Services.RoutingRules.ExpressionBranch":{"type":"object","required":["lhs","rhs"],"properties":{"lhs":{"type":"string"},"op":{"type":"string","enum":["is","is_not","matches","not_contains","gt","lt","gt_eq","lt_eq","call","field_is","field_is_not","field_gt","field_lt","field_gt_eq","field_lt_eq"]},"rhs":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer","format":"int32"},{"type":"number","format":"float"}]}}},"Common.V3.ErrorMeta":{"type":"object","required":["status","error_message"],"properties":{"status":{"anyOf":[{"type":"string"},{"type":"integer"}]},"error_message":{"type":"string"}},"description":"Represents a single response containing data of type T."}}},"paths":{"/v3/services/{serviceID}/routing-rules":{"get":{"operationId":"RoutingRules_getRoutingRules","summary":"Get Routing Rules","parameters":[{"name":"serviceID","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The request has succeeded.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"rules":{"type":"array","items":{"$ref":"#/components/schemas/V3.Services.RoutingRules.RoutingRuleResponse"}}},"required":["rules"]}},"required":["data"]}}}},"400":{"description":"The server could not understand the request due to invalid syntax.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"401":{"description":"Access is unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"402":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"403":{"description":"Access is forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"404":{"description":"The server cannot find the requested resource.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"409":{"description":"The request conflicts with the current state of the server.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"422":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"502":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"504":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}}},"tags":["Services/Routing Rules"]}}}}
```

## POST /v3/services/{serviceID}/routing-rules

> Create or Update Routing Rules

```json
{"openapi":"3.1.0","info":{"title":"Squadcast","version":"1.0.0"},"tags":[{"name":"Services/Routing Rules"}],"servers":[{"url":"https://api.squadcast.com","description":"production US env","variables":{}},{"url":"https://api.eu.squadcast.com","description":"production EU env","variables":{}}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"V3.Services.RoutingRules.RoutingRuleResponse":{"type":"object","allOf":[{"$ref":"#/components/schemas/V3.Services.RoutingRules.RoutingRule"}]},"V3.Services.RoutingRules.RoutingRule":{"type":"object","required":["expression","route_to","is_basic"],"properties":{"expression":{"type":"string"},"route_to":{"type":"object","properties":{"entity_type":{"type":"string","enum":["user","squad","escalation_policy"]},"entity_id":{"type":"string"}},"required":["entity_type","entity_id"]},"is_basic":{"type":"boolean"},"basic_expression":{"type":"array","items":{"$ref":"#/components/schemas/V3.Services.RoutingRules.ExpressionBranch"}}}},"V3.Services.RoutingRules.ExpressionBranch":{"type":"object","required":["lhs","rhs"],"properties":{"lhs":{"type":"string"},"op":{"type":"string","enum":["is","is_not","matches","not_contains","gt","lt","gt_eq","lt_eq","call","field_is","field_is_not","field_gt","field_lt","field_gt_eq","field_lt_eq"]},"rhs":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer","format":"int32"},{"type":"number","format":"float"}]}}},"Common.V3.ErrorMeta":{"type":"object","required":["status","error_message"],"properties":{"status":{"anyOf":[{"type":"string"},{"type":"integer"}]},"error_message":{"type":"string"}},"description":"Represents a single response containing data of type T."},"V3.Services.RoutingRules.CreateOrUpdateRoutingRulesRequest":{"type":"object","required":["rules"],"properties":{"rules":{"type":"array","items":{"$ref":"#/components/schemas/V3.Services.RoutingRules.RoutingRule"}}}}}},"paths":{"/v3/services/{serviceID}/routing-rules":{"post":{"operationId":"RoutingRules_createOrUpdateRoutingRules","summary":"Create or Update Routing Rules","parameters":[{"name":"serviceID","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"The request has succeeded and a new resource has been created as a result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"rules":{"type":"array","items":{"$ref":"#/components/schemas/V3.Services.RoutingRules.RoutingRuleResponse"}}},"required":["rules"]}},"required":["data"]}}}},"400":{"description":"The server could not understand the request due to invalid syntax.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"401":{"description":"Access is unauthorized.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"402":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"403":{"description":"Access is forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"404":{"description":"The server cannot find the requested resource.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"409":{"description":"The request conflicts with the current state of the server.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"422":{"description":"Client error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"502":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"503":{"description":"Service unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}},"504":{"description":"Server error","content":{"application/json":{"schema":{"type":"object","properties":{"meta":{"$ref":"#/components/schemas/Common.V3.ErrorMeta"}},"required":["meta"]}}}}},"tags":["Services/Routing Rules"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V3.Services.RoutingRules.CreateOrUpdateRoutingRulesRequest"}}}}}}}}
```
