---
title: "PATCH /api/v1/knowledge-health/findings/{findingKey}"
method: PATCH
path: "/api/v1/knowledge-health/findings/{findingKey}"
---

# PATCH /api/v1/knowledge-health/findings/{findingKey}

`PATCH /api/v1/knowledge-health/findings/{findingKey}`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/knowledge-health/findings/{findingKey}`
- Auth: none declared

## Path parameters

- `findingKey` string, required: findingKey from GET /knowledge-health/findings.

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Request body

- KhFindingUpdateRequest
  - `status` 'resolved' | 'ignored': "resolved" closes the finding; "ignored" dismisses it.
  - `ownerEmail` string, email, nullable: Email of an org member to assign as owner, or null to clear the owner.

## Response `200`

Update applied, or ok:false with a stale-findingKey message.

- union
  - object
    - `ok` true, required
    - `findingKey` string, required
    - `status` string
    - `owner` object, nullable
      - `name` string, nullable, required
      - `email` string, nullable, required
  - object
    - `ok` false, required
    - `message` string, required

## Other responses

- `400`: Bad request
- `403`: Knowledge Health v2 is not enabled for this organization

---

[API](https://skmtc.dev/falconer/apis/falconer-public-api.md) · [All operations](https://skmtc.dev/falconer/apis/falconer-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falconer/apis/falconer-public-api/revisions/c00420511526?raw)