---
title: "Update QA Rule"
method: PATCH
path: "/v1/qa-rules/{qaRuleId}"
tags: ["QA Rules"]
---

# Update QA Rule

`PATCH /v1/qa-rules/{qaRuleId}`

Partially updates an existing QA rule by qaRuleId. Only fields provided in the request body are updated — omitted fields remain unchanged. Returns the updated QA rule record.

## Path parameters

- `qaRuleId` string, required

## Request body

- UpdateQARuleRequest
  - `ruleName` string — The name of the QA rule, used to identify it in rule lists and evaluation reports.
  - `ruleDescription` string — A brief explanation of what this QA rule evaluates and its intended purpose.
  - `evaluationCriteria` string — The specific criteria used to evaluate agent responses against this rule.
  - `expectedValue` true | false — The expected outcome of the evaluation criteria that determines a successful QA result. Set to true if the evaluation criteria returning true should be treated as a Success, or false if the evaluation criteria returning true should be treated as a Fail.
  - `agentIds` string[] — List of agent Ids on which QA rule would apply

## Response `200`

OK

- QARuleResponse
  - `qaRuleId` string — The unique identifier of the QA rule.
  - `workspaceId` string — The unique identifier of the workspace this QA rule belongs to.
  - `ruleName` string — The name of the QA rule, used to identify it in rule lists and evaluation reports.
  - `ruleDescription` string — A brief explanation of what this QA rule evaluates and its intended purpose.
  - `agents` AgentResponse[]
    - `name` string — The display name of the assigned agent.
    - `agentId` string — The unique identifier of the agent within the system.
    - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
  - `evaluationCriteria` string — The specific criteria or rubric used to evaluate agent responses against this rule.
  - `expectedValue` boolean — The expected evaluation result that determines whether the QA rule is satisfied. When the evaluation criteria returns a result matching this expected value, the interaction is marked as a Success; otherwise it is marked as a Fail.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)