Skip to main content
POST
Create a rule (opens tickets automatically from matching conversations)

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json
name
string
required
Maximum string length: 120
condition
string
required

When to open a ticket, in plain language — the AI compares each finished conversation against this text

Example:

"The customer complained about the company, a product or a delivery, even if the AI agent apologised."

priority
enum<string>
default:normal
Available options:
low,
normal,
high,
urgent
assign_type
enum<string>
default:none
Available options:
none,
queue,
user
queue_uuid
string<uuid>

Required when assign_type = queue

assignee_email
string<email>

Required when assign_type = user

min_confidence
integer
default:70

A ticket is opened only when the AI is at least this sure the conversation matches

Required range: 30 <= x <= 100
is_active
boolean
default:true
agent_uuid
string<uuid>

Create the rule for ONE agent. If the agent still inherits, the workspace rules are first copied into its own set and this rule is added to it; from that moment the workspace rules no longer apply to this agent — only its own set does. Omit for a workspace rule.

Response

Rule created