Skip to main content
PUT
/
api
/
v1
/
qa-agents
/
{uuid}
/
skills
Replace the scorecard skills
curl --request PUT \
  --url https://{subdomain}.mihu.ai/api/v1/qa-agents/{uuid}/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skills": [
    {
      "name": "Greeting",
      "weight": 15,
      "description": "Professional opening and introduction"
    },
    {
      "name": "Empathy",
      "weight": 20,
      "description": "Understanding and acknowledging customer concerns"
    },
    {
      "name": "Compliance",
      "weight": 25,
      "description": "Adherence to regulatory and company policies",
      "penalty_items": [
        {
          "name": "Skipped identity verification",
          "penalty_points": -10,
          "is_auto_fail": true
        }
      ]
    },
    {
      "name": "Resolution",
      "weight": 25,
      "description": "Effective problem solving and issue resolution"
    },
    {
      "name": "Sales",
      "weight": 15,
      "description": "Upselling and cross-selling opportunities"
    }
  ]
}
'
{
  "success": true,
  "message": "Skills replaced successfully",
  "data": {
    "uuid": "7e1c9b3a-5d2f-4c8e-b6a1-0f9d8c7b6a5e",
    "name": "Support QA Agent",
    "description": "Evaluates support conversations for empathy and compliance",
    "evaluates_agent_type": "human",
    "is_active": true,
    "is_default": true,
    "evaluation_model": "advanced",
    "strictness_level": 70,
    "confidence_threshold": 85,
    "auto_fail_threshold": 3,
    "language": "English",
    "custom_instructions": "Focus on product knowledge when evaluating technical support calls.",
    "automatic_scoring": true,
    "sentiment_analysis": true,
    "compliance_checking": true,
    "skills": [
      {
        "uuid": "9c2f5a44-1b7e-4f4a-9a6c-3d2f8e7b1c0a",
        "name": "Empathy",
        "description": "Understanding and acknowledging customer concerns",
        "weight": 20,
        "max_score": 10,
        "ai_evaluation_prompt": "Evaluate whether the agent acknowledged the customer's feelings.",
        "positive_items": [
          {
            "name": "Used the customer's name",
            "points": 5
          }
        ],
        "penalty_items": [
          {
            "name": "Interrupted the customer",
            "penalty_points": -5,
            "is_auto_fail": false
          }
        ],
        "order": 2,
        "is_custom": false
      }
    ],
    "total_weight": 100,
    "weights_balanced": true,
    "created_at": "2026-06-04T10:15:30+00:00",
    "updated_at": "2026-06-04T10:15:30+00:00"
  }
}

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uuid
string<uuid>
required

The QA agent's uuid.

Body

application/json
skills
object[]
required
Minimum array length: 1

Response

Skills replaced successfully

success
boolean
Example:

true

message
string
Example:

"Skills replaced successfully"

data
object

A QA agent with its full scorecard.