Skip to main content
PATCH
/
quality
/
scorecard
/
{id}
Update a quality scorecard
curl --request PATCH \
  --url https://demo.enneo.ai/api/mind/quality/scorecard/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Voice - Tier 2 escalation (v2)",
  "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": {
    "teams": [
      12
    ],
    "channels": [
      "phone"
    ]
  },
  "createNewRevision": false
}
'
{ "scorecard": { "id": 42, "baseId": 17, "revision": 3, "name": "Email QA - Tier 1", "state": "active", "categories": [], "assignment": { "teams": [ 5 ], "channels": [ "email" ] }, "modifiedAt": "2024-06-01T10:30:00Z", "canEdit": true }, "message": null }

Authorizations

Authorization
string
header
required

JWT-based authentication

Path Parameters

id
integer
required

Scorecard ID

Body

application/json
name
string

Name of the scorecard

state
enum<string>

State of the scorecard

Available options:
draft,
active,
retired,
deleted
categories
object[]

Categories with nested criteria definitions

assignment
object

Assignment rules (optional)

createNewRevision
boolean
default:true

If true (default) and the scorecard is active, creates a new revision instead of overwriting.

Response

Scorecard updated successfully

scorecard
object

Quality scorecard for assessing agent performance

message
string | null

Set when the server transparently redirected the update to the latest revision.