Skip to content

List routing rules

GET/omnichannel/routing-rules

Returns all routing rules for the tenant, ordered by priority (ascending). Rules are evaluated in priority order against each incoming conversation's attributes to determine assignment and channel-profile routing.

Request

This endpoint takes no parameters and no request body.

Responses

200 List of routing rules ordered by priority

Content type application/json, array of object · OmnichannelRoutingRuleV1.

FieldTypeRequiredDescription
idintegerNo

Auto-incremented primary key.

namestringNo

Human-readable rule name.

priorityintegerNo

Evaluation order — lower numbers are evaluated first.

is_activebooleanNo

When false, the rule is skipped during routing evaluation.

conditionsarray of objectNo

Array of condition objects (field, op, value) that must all match.

actionsarray of objectNo

Array of action objects executed when all conditions match.

created_atstring (date-time)No
updated_atstring (date-time)No

Example

[
  {
    "id": 1,
    "name": "VIP customer — assign to senior agents",
    "priority": 10,
    "is_active": true,
    "conditions": [
      {
        "field": "priority",
        "op": "eq",
        "value": "urgent"
      }
    ],
    "actions": [
      {
        "type": "assign_profile",
        "profile_id": 5
      }
    ]
  }
]

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/omnichannel/routing-rules" \
  -H "Accept: application/json"
Loading