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).
| Field | Type | Required | Description |
|---|---|---|---|
conversation_id | integer | Yes | ID of the ticket or conversation being evaluated. |
score | number | Yes | Overall quality score from 0 to 100. Minimum: 0 · Maximum: 100 |
reviewer_id | integer | Yes | Tenant user ID of the person conducting the review. |
rubric_results | map of number, nullable | No | Optional breakdown of scores by rubric dimension (e.g. empathy, resolution accuracy). Keys are dimension names; values are scores. |
notes | string, nullable | No | 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."}'