Skip to content

Create QA scorecard

POST/support/qa-scorecards

Submits a quality assurance scorecard for a specific support conversation. The reviewer provides a numeric score and optionally a rubric breakdown. Use this to formalise agent performance reviews in the support workflow.

Request

Request body

Content type application/json (required).

FieldTypeRequiredDescription
conversation_idintegerYes

ID of the ticket or conversation being evaluated.

scorenumberYes

Overall quality score from 0 to 100.

Minimum: 0 · Maximum: 100

reviewer_idintegerYes

Tenant user ID of the person conducting the review.

rubric_resultsmap of number, nullableNo

Optional breakdown of scores by rubric dimension (e.g. empathy, resolution accuracy). Keys are dimension names; values are scores.

notesstring, nullableNo

Optional coaching notes or observations from the reviewer.

Example

{
  "conversation_id": 892,
  "score": 87.5,
  "reviewer_id": 4,
  "rubric_results": {
    "empathy": 9,
    "resolution_accuracy": 8,
    "communication": 9
  },
  "notes": "Strong empathy shown. Needs to confirm resolution before closing."
}

Responses

302 Redirect to QA scorecards list after creation

422 Validation error

Example request

curl -X POST "https://{tenant}.faciotech.net/api/v1/support/qa-scorecards" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id": 892, "score": 87.5, "reviewer_id": 4, "rubric_results": {"empathy": 9, "resolution_accuracy": 8, "communication": 9}, "notes": "Strong empathy shown. Needs to confirm resolution before closing."}'
Loading