Skip to main content
POST
/
quality
/
scorecard
Create a new quality scorecard
curl --request POST \
  --url https://demo.enneo.ai/api/mind/quality/scorecard \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Voice - Tier 2 escalation",
  "state": "active",
  "categories": [
    {
      "categoryId": 1,
      "label": "Greeting",
      "order": 1,
      "criteria": [
        {
          "id": 100,
          "label": "Tone",
          "description": "Agent greets the customer within 10 seconds",
          "maxPoints": 5,
          "scoringType": "numericScale",
          "autoGenerateByAi": false,
          "assessmentPrompt": "Score how friendly the greeting was.",
          "makeOrBreakForCategory": false,
          "makeOrBreakForAssessment": true
        }
      ]
    }
  ],
  "assignment": {
    "ticketTags": [
      88
    ],
    "teams": [
      12,
      14
    ],
    "channels": [
      "phone"
    ]
  }
}
'
{
  "id": 58,
  "baseId": 58
}

Authorizations

​
Authorization
string
header
required

JWT-based authentication

Body

application/json

Provide the complete scorecard payload as JSON.

​
name
string
required

Name of the scorecard

Example:

"Junior agent standard review"

​
categories
object[]
required

Categories with nested criteria definitions

Example:
[
  {
    "categoryId": 1,
    "label": "Opening",
    "order": 1,
    "criteria": [
      {
        "id": 10,
        "label": "Greeting",
        "description": "Did the agent greet the customer properly?",
        "maxPoints": 5,
        "scoringType": "numericScale",
        "autoGenerateByAi": false,
        "assessmentPrompt": "Evaluate the opening.",
        "makeOrBreakForCategory": false,
        "makeOrBreakForAssessment": false
      }
    ]
  }
]
​
state
enum<string>
default:active

State of the new scorecard (defaults to active if omitted)

Available options:
draft,
active
​
assignment
object

Assignment rules (optional)

Example:
{
  "ticketTags": [101, 102],
  "teams": [5, 7],
  "channels": ["email"]
}

Response

Scorecard created successfully

​
id
integer

ID of the created scorecard

​
baseId
integer

Base ID of the created scorecard (used for future revisions)