Auditmark

Update a finding

PATCH
/findings/{finding_id}/content

Correct a finding you raised, while its inspection is still in progress.

The field's own edit, beside the review sheet's bin, and deliberately as narrow as the bin: only the inspector who raised the finding, and only before the inspection is submitted. After that the finding is part of a record (and possibly a report), so changing it is back-office work rather than a field action. Admin label assignment keeps its own route.

Omit a field to leave it unchanged. An explicit null clears the description or the label; a null title or priority is rejected. Returns the finding in its full read shape.

Authorization

OrgApiKey
AuthorizationBearer <token>

Organization API key. Send as Authorization: Bearer <key>. Create one in Admin > Settings > API keys.

In: header

Path Parameters

finding_id*Finding Id

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Partial update of a finding's content. Omit a field to leave it unchanged.

An explicit null clears the description or the label. A null title or priority is rejected; omit the field instead. The title is stored trimmed and cannot be blank.

Response Body

application/json

application/json

curl -X PATCH "https://api.auditmark.io/v1/findings/497f6eca-6276-4993-bfeb-53cbbbba6f08/content" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "inspection_id": "c9b5b83c-f311-4a73-99d1-5e571dd2460c",  "client_account_id": "219adf14-412b-4051-82f8-967a3418e740",  "priority": "string",  "status": "string",  "title": "string",  "response_id": "696f09c4-2678-4263-8db2-0a7204e502c2",  "instance_path": "string",  "description": "string",  "created_at": "string",  "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",  "photos": [],  "label_id": "03e7493c-608b-4c34-83b8-041808788ef3",  "label": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "color": "string"  }}
{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string",      "input": null,      "ctx": {}    }  ]}