---
title: "Update bug fields"
method: PATCH
path: "/v1/bugs/{bug_uuid}"
tags: ["bugs"]
---

# Update bug fields

`PATCH /v1/bugs/{bug_uuid}`

Sparse update for editable MCP bug fields: summary, steps, status, failure_classification, app_file_id, and metadata. Omitted fields stay unchanged. Explicit `app_file_id: null` clears the current app-build association; non-null app_file_id values must belong to the caller's organization and not be soft-deleted. Writes a `bug_status_changes` audit row with `source = "mcp"` only on real status transitions.

## Path parameters

- `bug_uuid` string, required

## Headers

- `x-api-key` string

## Request body

- UpdateBugBody — Sparse body for PATCH /v1/bugs/{id}. Omitted fields stay unchanged. Explicit ``app_file_id: null`` clears the app-build association; non-null values are org-scoped before write.
  - `summary` string, nullable
  - `steps` string, nullable
  - `status` 'open' | 'in_progress' | 'fixed' | 'wont_fix', nullable
  - `failure_classification` 'app_bug' | 'setup_issue', nullable — Classifies the issue as an app bug or setup issue.
  - `app_file_id` string, uuid, nullable — UUID of an uploaded app build in the caller's organization. Explicit null clears the current app-build association.
  - `metadata` object, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/qualgent/apis/qualgent-api-service.md) · [All operations](https://skmtc.dev/qualgent/apis/qualgent-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qualgent/qualgent-api-service/revisions/2372ed4904a6/schema)