Update a snag's editable fields

PUT

/handover/cases/{caseId}/snags/{snagId}

Maintainer:Not configured

Updates title, room/area, category, priority (severity), description and photos. Only editable fields are updated — status lifecycle changes use dedicated endpoints (resolve, waive, assign, in-progress).

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

API Key

Add parameter in header

x-tenant-id

Example:

x-tenant-id: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Snag updated successfully

Body

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/handover/cases//snags/' \
--header 'Authorization: Bearer <token>' \
--header 'x-tenant-id: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "handoverCase": "790ff744-1aa2-472f-9138-81e0dfa24dba",
    "snagNumber": "string",
    "roomArea": "string",
    "title": "string",
    "category": "PLASTERING",
    "description": "string",
    "photoUrl": "string",
    "photoUrls": [
        "string"
    ],
    "severity": "CRITICAL",
    "snagStatus": "OPEN",
    "assignedTo": "string",
    "slaDueAt": "2019-08-24T14:15:22.123Z",
    "slaHoursRemaining": 0,
    "resolved": true,
    "resolvedAt": "2019-08-24T14:15:22.123Z",
    "resolvedBy": "string",
    "reInspectionDate": "2019-08-24T14:15:22.123Z",
    "reInspectionNotes": "string",
    "waived": true,
    "waivedAt": "2019-08-24T14:15:22.123Z",
    "waivedBy": "string",
    "waiverRemarks": "string",
    "buyerSignedOff": true,
    "buyerSignedOffAt": "2019-08-24T14:15:22.123Z",
    "buyerNotes": "string",
    "reraLiabilityExpiresAt": "2019-08-24T14:15:22.123Z",
    "created": "2019-08-24T14:15:22.123Z"
}'

Response Example

200 - Success

{
    "id": "55555555-5555-5555-5555-555555555555",
    "snagNumber": "SNG-001",
    "roomArea": "Bedroom 1",
    "title": "Window seal gap in bedroom 1",
    "category": "CARPENTRY",
    "severity": "MAJOR",
    "description": "Updated description after re-inspection."
}

Modified at 2026-04-16 18:43:47

Get a single snag by ID

Waive a snag