Skip to main content
POST
Create Evaluator
The sum of all non-strict criterion weights must equal exactly 100. The weight of strict criteria is automatically set to 0 regardless of what you send.
The description of each criterion is the text the AI uses to evaluate the call. A clear, specific description directly improves evaluation accuracy. For guidance on writing effective criteria, see Evaluator — criteria.
language defaults to "df" (auto-detect from audio). See Evaluator — language for supported language codes.
Maximum 20 evaluators per account and 10 criteria per evaluator. See Rate Limits & Quotas.

Authorizations

x-api-key
string
header
required

Body

application/json
tag
string
required

Name/label for the evaluator. Max 100 characters.

criteria
object[]
required

List of evaluation criteria. Min 1, max 10 items. Non-strict weights must sum to exactly 100.

description
string | null

Description of the evaluator's purpose. Max 250 characters.

Maximum string length: 250
language
string
default:df

Language for AI evaluation output. "df" (default) auto-detects from audio. See Evaluator — language for supported codes.

context
string | null

Additional context provided to the AI during evaluation. Helps the model understand the business scenario. Max 1000 characters.

Maximum string length: 1000

Response

201 - application/json

Evaluator created successfully.

data
object